Issue Gift Card
Begin a random-amount gift card issuance.
Persists the Charge and pending IssuedGiftCard synchronously (so the
row shows up in the issued list immediately with status=PENDING) and
returns the Rainforest payin config the client uses to embed the payment
terminal. The payin.processing webhook then activates the card.
Headers
The tenant you are making this request on behalf of
Your api key
Body
Staff-initiated, random-amount gift card issuance from /settings/gift-cards.
Runs through the regular checkout pipeline: a synthetic archived GiftCardItem carries the requested denomination, the Charge and pending IssuedGiftCard are persisted synchronously so the row appears in the issued list immediately, and the rainforest webhook activates the card once the payin lands.
Gift card value in cents.
Purchasing patient. Required because the charge pipeline is patient-scoped.
Required when the tenant has the LOCATIONS module enabled.
Recipient patient. When omitted, the card belongs to the purchaser.
Personal message from the sender included in the recipient notification.
When set, the recipient notification is deferred until this time instead of sending immediately on activation.
When True, the recipient is not auto-notified (neither on activation nor via the scheduled-send heartbeat). Only meaningful when a recipient is set; staff can still send manually later.
Optional provider-entered code. Trimmed and stored uppercase when supplied.
