Sign in

v1

latestOpenAPI 3.0.02026-07-2464438356.8 KB
Payouts

Execute an end-user custodial Payout Request

Executes a Payout Request using an end-user custodial signature.

post/api/payouts/payout/end-user-custodial/execute/{id}

Path parameters

idstring uuid required

Payout request ID

Headers

on-behalf-ofstring required

Organization ID to act on behalf of

idempotency-keystring uuid

Optional UUID to safely retry requests without creating duplicate operations. Subsequent requests with the same key and identical body return the original cached response with an idempotency-replayed: true response header. Keys expire after 24 hours.

Request body

exchangeRateToleranceMode'STRICT' | 'FLEXIBLE'

Exchange rate checking behavior for payout execution. FLEXIBLE: Execute the payout regardless of exchange rate changes. STRICT: Fail with PayoutQuoteExpiredException if rates have changed (see Errors section in documentation).

signaturestring required

The signature to authorize the payout execution.

Example request

{
  "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}

Response

Successfully executed Payout Request via an end-user custodial signature

createdAtstring date-time required
idstring uuid required
memostring
sourceAccountIdstring uuid required
status'AWAITING_EXECUTION' | 'CANCELED' | 'PENDING' | 'EXECUTED' | 'FAILED' required

DEPRECATED: use statusV2 instead. The status of the overall payout request. The initial status is AWAITING_EXECUTION, and the status will change to PENDING. EXECUTED, FAILED, and CANCELED are terminal statuses. EXECUTED indicates the blockchain transaction associated with the entire payout has been executed, but that does not mean your recipients have received funds. Check the individual recipientsPayoutDetails for the status of each recipient.

transactionHashstring

The transaction hash of the blockchain transaction. Present when the status is EXECUTED.

updatedAtstring date-time required

Example response

{
  "payouts": [
    {
      "amount": {
        "tokenSymbol": "USDC"
      },
      "details": {
        "feeTotal": {
          "tokenSymbol": "USDC"
        },
        "fiatAmount": {
          "fiatCurrencyCode": "USD"
        },
        "transactionFee": {
          "tokenSymbol": "USDC"
        }
      },
      "recipientInfo": {
        "details": {
          "details": {
            "truncatedBankAccountNumber": "****1234"
          }
        }
      }
    }
  ]
}