Customer withdrawals

Customer withdrawals debit a merchant-scoped customer's exact chain-and-asset balance. Discover the enabled assets and current fee policy before accepting a withdrawal request:

GET /api/v1/withdrawal-assets

Endpoints

curl https://api-prod.paybytoken.io/api/v1/customers/cus_123/withdrawals \
  -X POST \
  -H "Authorization: Bearer $PAYBYTOKEN_SECRET_KEY" \
  -H "Idempotency-Key: withdrawal:merchant_customer_8:1" \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "base",
    "asset": "USDC",
    "amount": "10.15",
    "destination_address": "0x1111111111111111111111111111111111111111",
    "reference": "merchant_withdrawal_42"
  }'

The debit includes the withdrawal amount plus the quoted fee. Creation may return an asynchronous pending state; fulfill customer-facing status from signed customer_withdrawal.* events or an authenticated retrieval. Validate and confirm the chain and destination in the merchant product; blockchain settlement is generally irreversible.