Card Issue (Beta)
Beta. Card issuance is in beta and enabled per account. Contact support@henrylabs.ai to request access; until then this endpoint returns 403.
Issue a virtual card for one purchase, paid for by your buyer’s card. Henry Labs charges the buyer’s tokenized card (fundingCardToken) for the card’s cap — off-session, using the payment method saved when the card was tokenized, so no CVC is needed — then issues a card capped at that amount and locked to the first merchant that charges it. The buyer’s statement shows HENRY* <MERCHANT> when you pass merchantHost.
The response is a cardToken you pass to cart.checkout.purchase exactly like a tokenized card. Read it back with GET /card/{cardToken} and close it with POST /card/{cardToken}/close; when it closes or expires, the buyer is refunded whatever it didn’t spend.
Send an Idempotency-Key header: retries with the same key return the same card and never charge twice.
Your app has a per-card maximum and an open-card limit: the summed caps of cards that haven’t settled.
Authorizations
Body
Lifetime spend limit in cents: the most the card can ever be charged, in total. Rounded up to the next whole dollar; must be at least 100 and, after rounding, at most your app's per-card maximum. Size it to the order total plus tax and shipping — a charge that would take total spend above the cap is declined.
x <= 90071992547409915000
Required. The buyer's tokenized card, collected with the Card Element, that pays for this one. It's charged the card's cap (rounded up to whole dollars) before the card is created; whatever the card doesn't spend is refunded to it when the card settles. Charged off-session, so your buyer must have agreed to future charges when they entered the card.
"card_live_SimDpKU9cmU7tvdUXHzOeLudtgfadQVnbof"
Merchant the card is for, e.g. zara.com. Puts the merchant on the buyer's statement (HENRY* ZARA). The card itself locks to whichever merchant charges it first.
"zara.com"
Days until the card expires and stops working. Defaults to your app's configured TTL. The card settles (refunding the buyer whatever it didn't spend) when it expires, or sooner if you close it.
x <= 907