Write · Workspace: required (from goody_workspaces_list)
A quick price estimate — cart subtotal, tax, shipping, and total — before sending. Use it when the user just wants a number; use goody_order_batches_preview for the richer confirm-against-it step that returns a shareable link. Nothing is charged.
Relay the total, the
from_name, and the notification_preview before calling goody_order_batches_create.Parameters
Workspace UUID — from
goody_workspaces_list. Scopes the estimate to this workspace.A single product UUID — from
goody_products_search. Use this or cart, never both.Quantity for
product_id. Defaults to 1.Amount to fund, in cents, for a variable-amount Gift of Choice or variable gift card. Must fall within the gift’s
[price_min, price_max]. Only applies to product_id.A multi-item cart — an object with an
items array (not a bare array). Use this or product_id, never both.A single saved-contact UUID — from
goody_contacts_search. Use this or recipients.The people to send to. Use this or
contact_id.How the recipient receives the gift. One of
link_single, email_and_link, or direct_send (ships a physical product — requires a mailing_address on every recipient). Affects shipping in the estimate.Whether the recipient may swap the gift. One of
single (swap once), multiple (swap freely), or disabled (no swapping).The “From” name the recipient sees. When the user states a From name, pass it. Defaults to the authenticated user.
Optional. A funding source — from
goody_payment_methods_list. When supplied, the result echoes the resolved payment_method so the user can confirm where the charge would land.Returns
The cart subtotal before tax and shipping.
The full total — subtotal, tax, and shipping. Relay this to the user.
The resolved sender name. Show it to the user so they can confirm who the gift is from.
How recipients are reached for the chosen
send_method (e.g. emailed a link, or shipped directly). State this before sending.The resolved funding source — present only when a
payment_method_id was supplied.