Payouts
Cancel a payout
Cancels a payout that was not sent. It becomes canceled and a payout.canceled webhook is sent.
Returns 409 invalid_state in three cases:
- The payout was already sent or has ended.
- The payout wallet already sent coins to the payout's NEAR Intents deposit address; those coins are still delivered.
- The payout was prepared in the dashboard and the coins may already have left the wallet. A same-coin payout can then be canceled only in the dashboard; a converted one can be canceled through the API once its deposit address stops accepting coins.
Rate limit: 60 per minute per API key, shared with the other endpoints that have this limit.
bearerAuthAuthorizationBearer <token>A live API key, sk_live_ followed by 32 base58 characters.
id*stringRefund id (starting with ref_) or payout id (starting with pay_).
Idempotency-Key?stringA unique string of 1 to 255 characters for this operation. A key belongs to the business across every endpoint for 24 hours, so give each operation its own key, for example invoice-order-1042 and refund-order-1042, not the order id alone. A retry with the same key on the same endpoint and with the same body returns the stored response with the header Idempotent-Replayed: true. The same key with a different body or on another endpoint returns 409 idempotency_conflict. Errors are not stored, so a request that failed can be retried with the same key, even with a corrected body. While the first request with a key is still running, a retry gets 409 idempotency_conflict with Retry-After: 1.
1 <= length <= 255The canceled payout.
application/json- response
A refund or a payout. Money leaves the business's payout wallet only after the business approves it at sign_url.
id*stringStarts with ref_ for refunds and pay_ for payouts.
object*string"refund""payout"status*string"pending""processing""completed""failed""canceled"invoice_id*string|nullbatch_id*|Set for payouts created together, from a CSV in the dashboard or with POST /api/v1/payouts/batch.
amount*stringAmount of the business's settlement coin to send.
source_asset*stringThe business's settlement coin.
asset_id*stringThe coin the recipient receives.
recipient*stringtx_hash*string|nullfailure_reason*string|nullsign_url*stringDashboard page where the business approves the transfer from its payout wallet.
uricreated_at*stringdate-timecurl -X POST 'https://example.com/api/v1/payouts/string/cancel'{ "id": "string", "object": "refund", "status": "pending", "invoice_id": "string", "batch_id": "string", "amount": "string", "source_asset": "string", "asset_id": "string", "recipient": "string", "tx_hash": "string", "failure_reason": "string", "sign_url": "http://example.com", "created_at": "2019-08-24T14:15:22Z"}