Confirm a claim
Pay a claimable payout on the locked quote from POST /claimable-payouts/claim/quote. The payout becomes CLAIMED, and Grid signs the payout from the sender’s wallet with the agent’s delegated key; it becomes PAID when the payout completes, or FAILED. A quote that has expired is refused with QUOTE_EXPIRED: request another. Confirming a payout already CLAIMED or PAID on the same quote returns it unchanged.
Authorizations
API token authentication using format <api token id>:<api client secret>
Body
Response
Claim confirmed
A claimable payout as its claim token shows it to the platform. Show the recipient no more than senderName and amount until she has proved she holds recipient.phoneNumber or recipient.email.
The claimable payout's identifier.
"ClaimablePayout:019542f5-b3e7-1d02-0000-000000000077"
Status of a claimable payout. Grid holds the amount against the sender's
Embedded Wallet balance and the agent's spending limits from creation until
the payout is PAID, or releases it when the payout ends in any other
status.
PENDING_APPROVAL, AWAITING_CLAIM, CLAIMED, PAID, EXPIRED, CANCELLED, FAILED The sender's first name, from their verified identity.
"Kevin"
The person a claimable payout is for. Exactly one of phoneNumber and email is set: the one-time code that proves the recipient holds the link goes there.
When the claim window ends.
"2025-10-10T15:00:00Z"
The sender's note to the recipient.
"Happy birthday, Mom"
What the recipient receives. Present once she has a locked quote.
The rail the recipient chose. Present once she has a locked quote.
ACH, ACH_COLOMBIA, ACH_SAME_DAY, BANK_TRANSFER, BRE_B, CIPS, FAST, FASTER_PAYMENTS, FEDNOW, INSTAPAY, MOBILE_MONEY, NEFT, PAYNOW, PESONET, PIX, RTGS, RTP, SEPA, SEPA_INSTANT, SPEI, SWIFT, UNIONPAY, UPI, WIRE "ACH"
Present only when status is FAILED.
INSUFFICIENT_FUNDS, RECIPIENT_REFUSED, AGENT_INACTIVE, PAYOUT_FAILED