Prefunded payouts must be enabled for your organization. Ask your Zapyd account manager for a prefunded wallet address. Without one, these endpoints return
This endpoint is not available for your organization.https://sandbox.zapyd.com/pos/api/v1/prefunded/payout
Flow
1
Top up the balance
Send USDT or USDC to your prefunded wallet address. Check the balance with The balance is cached briefly, so a top-up can take a moment to appear.
GET /pos/api/v1/payout/balance:2
Create a quotation
POST /prefunded/payout/quotation takes the same body as a standard payout quotation. network is ignored: the quotation always uses your prefunded wallet’s network.3
Check the balance covers it
Compare the quotation’s
sending_amount with available_balance for that asset. If the balance is too low, top up before you initiate.4
Initiate
POST /prefunded/payout/initiate needs the quotation and both parties. receiver.id must be the quotation’s customer. sender.id is the customer paying, and Zapyd stores it for reference.PROCESSING.5
Track
Statuses and webhooks are the same as for standard payouts. To poll, use
GET /prefunded/payout/{payout_id} or GET /prefunded/payout/history.