`issueGiftCard`

Issue Gift Card

Issue ONE gift card directly, with no order behind it: the counter sale.

write

Arguments

amountMinorintegerrequiredFace value in minor units (cents), e.g. 5000 = $50.00. Capped at 1000000 ($10,000).
appIdstringrequiredThe Studio app ID whose shop is selling.
issuanceKeystringrequiredYour idempotency key for THIS sale. Reuse it to retry safely; use a new one for a new card.
recipientEmailstringoptionalEmail the code to this address. Omit for an in-store sale; the code comes back in this response instead.

Returns

Idempotent per issuanceKey: reuse the SAME key when retrying one sale (a replay returns the card with no code), and a NEW key for a genuinely new sale.

Declared limits

amountMinor: greater than 0
amountMinor: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

sell a $50 gift card
issue a gift card for this customer
make a gift card for Sam

Pair it with

The verbs that finish the job.

listGiftCards
voidGiftCard