Payout Crypto

curl -X POST "https://sandbox-api.tender.cash/v1/api/payout/crypto" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payout-2026-10-15-0001" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>" \
  -d '{"coin":"usdt","chain":"tron","amount":"50","address":"TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT"}'

curl -X POST "https://sandbox-api.tender.cash/v1/api/payout/crypto" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payout-2026-10-15-0002" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 6f1c2a4e-8b3d-4c5e-9f7a-1b2c3d4e5f60" \
  -H "x-timestamp: 2026-10-15T09:46:10.000Z" \
  -H "authorization: <signature>" \
  -d '{"coin":"usdt","chain":"tron","amount":"50","payoutAccountId":"66aec7de809b7f45c42a49f9"}'

{
  "status": "success",
  "message": "success",
  "data": {
    "_id": "66aec7de809b7f45c42a49f9",
    "type": "crypto",
    "status": "pending",
    "coin": "usdt",
    "chain": "tron",
    "address": "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT",
    "amount": "49.5",
    "totalAmount": "50",
    "usdValue": "49.5",
    "totalAmountUSD": "50",
    "fee": "0.5",
    "feeUSD": "0.5",
    "createdAt": "2026-10-15T09:20:15.650Z",
    "updatedAt": "2026-10-15T09:20:15.650Z"
  }
}

{
  "status": "error",
  "message": "Idempotency-Key was already used with a different request",
  "data": {}
}

POST

api

payout

crypto

curl -X POST "https://sandbox-api.tender.cash/v1/api/payout/crypto" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payout-2026-10-15-0001" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>" \
  -d '{"coin":"usdt","chain":"tron","amount":"50","address":"TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT"}'

curl -X POST "https://sandbox-api.tender.cash/v1/api/payout/crypto" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payout-2026-10-15-0002" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 6f1c2a4e-8b3d-4c5e-9f7a-1b2c3d4e5f60" \
  -H "x-timestamp: 2026-10-15T09:46:10.000Z" \
  -H "authorization: <signature>" \
  -d '{"coin":"usdt","chain":"tron","amount":"50","payoutAccountId":"66aec7de809b7f45c42a49f9"}'

{
  "status": "success",
  "message": "success",
  "data": {
    "_id": "66aec7de809b7f45c42a49f9",
    "type": "crypto",
    "status": "pending",
    "coin": "usdt",
    "chain": "tron",
    "address": "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT",
    "amount": "49.5",
    "totalAmount": "50",
    "usdValue": "49.5",
    "totalAmountUSD": "50",
    "fee": "0.5",
    "feeUSD": "0.5",
    "createdAt": "2026-10-15T09:20:15.650Z",
    "updatedAt": "2026-10-15T09:20:15.650Z"
  }
}

{
  "status": "error",
  "message": "Idempotency-Key was already used with a different request",
  "data": {}
}

Auth method: Signed (HMAC) — this endpoint requires the full set of signed headers: x-access-id, x-request-id, x-timestamp, and an HMAC-SHA256 authorization signature. See Authentication.

Sends amount of coin on chain from your merchant balance. No OTP or password is needed; the signed headers authenticate the request. The fee is taken out of amount: your balance is debited amount and the recipient receives amount − fee. Check the fee first with Calculate Payout Fee. The payout is created with status pending and processed asynchronously. There are no payout webhooks: poll Get Payout with the returned _id until status is completed or failed.

All payout endpoints share a bucket of 10 requests per minute per merchant, and each call to this endpoint counts twice, so you can create about 5 crypto payouts per minute. See Rate limits.

Headers

string

required

Base64-encoded HMAC-SHA256 signature of {"timeStamp":"<x-timestamp>","requestId":"<x-request-id>","accessId":"<x-access-id>"}, signed with your access secret. The request body is not part of the signature.Example: "pV3n0o8kq0lK2mJ8bZ1yq3Yt6hR0cXK9u4mVJ2l9sE0="

string

required

ISO 8601 timestamp; must be within 5 minutes of server timeExample: "2026-10-15T09:45:53.000Z"

string

required

A unique UUID v4 per requestExample: "550e8400-e29b-41d4-a716-446655440000"

string

required

Your API access ID provided by TenderExample: "your-access-id-here"

string

required

Must be application/jsonExample: "application/json"

string

required

A unique key you generate for this payout, up to 200 characters (a UUID works well). Retrying with the same key and the same body returns the original response instead of creating a second payout. See Idempotency.Example: "payout-2026-10-15-0001"

Body

string

required

Coin ID to pay outExample: "usdt"

string

required

Chain ID to send onExample: "tron"

string

required

Amount to pay out, in the coin, as a string. Must be worth at least $20 USD.Example: "50"

string

Destination wallet address on chain. Required if payoutAccountId is not sent.Example: "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT"

string

ID of one of your saved, active crypto payout accounts. Its chain and coin must match chain and coin. Required if address is not sent. If you send both, the saved account’s address is used and address is ignored.Example: "66aec7de809b7f45c42a49f9"

Idempotency

Send a unique Idempotency-Key header with every payout request. Keys are scoped to your merchant account and to this endpoint, and are kept for 24 hours.

Same key, same body: you get the original response again; no new payout is created.
Same key, different body: 409 with Idempotency-Key was already used with a different request.
Same key while the first request is still running: 409 with A request with this Idempotency-Key is already being processed. Wait and retry.
First request failed: the key is released, so you can retry with the same key.
Missing key: 400 with Idempotency-Key header is required.

See Idempotency.

Response

string

required

success on successExample: "success"

string

required

Human-readable result messageExample: "success"

object

required

The new payout record

Show data properties

string

Payout ID. Use it with Get Payout.Example: "66aec7de809b7f45c42a49f9"

string

Always cryptoExample: "crypto"

string

Always pending on creationExample: "pending"

string

Example: "usdt"

string

Example: "tron"

string

Destination addressExample: "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT"

string

Net amount the recipient receives (totalAmount − fee)Example: "49.5"

string

The amount you requested, debited from your balanceExample: "50"

string

USD value of amountExample: "49.5"

string

USD value of totalAmountExample: "50"

string

Fee in the coinExample: "0.5"

string

Fee in USDExample: "0.5"

string

Present when you paid out to a saved account

string

Example: "2026-10-15T09:20:15.650Z"

string

Example: "2026-10-15T09:20:15.650Z"

Additional fields may be present; ignore fields you don’t recognise.

Errors

HTTP	Message	Cause
400	`Idempotency-Key header is required`	The header is missing or blank
400	`Idempotency-Key header is too long`	The key is over 200 characters
400	`Invalid Chain` / `Invalid Currency`	Unknown `chain` or `coin`
400	`Exchange Price Error`	No price is available for the coin
400	`Invalid payout account reference` / `Payout account not found` / `Payout account is inactive`	`payoutAccountId` is unknown, not yours, or inactive
400	`Account type mismatch. Expected crypto account`	`payoutAccountId` is a bank account
400	`Saved account chain does not match withdrawal chain`	`payoutAccountId` is on a different chain
400	`Saved account coin does not match withdrawal coin`	`payoutAccountId` is for a different coin
400	`Insufficient balance for usdt. ...`	Your available balance on this chain is below `amount`
400	`Invalid Address`	`address` is not valid for `chain`
400	`Minimum withdrawal amount is $20 USD`	`amount` is worth less than $20
400	`Withdrawal exceeds your 30-day offramp limit (...)`	The payout would exceed your account’s 30-day limit
400	`Failed to create crypto withdrawal`	The payout could not be created; retry with the same key
409	`Idempotency-Key was already used with a different request`	Reused key with a different body
409	`A request with this Idempotency-Key is already being processed`	The first request with this key hasn’t finished

curl -X POST "https://sandbox-api.tender.cash/v1/api/payout/crypto" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payout-2026-10-15-0001" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 550e8400-e29b-41d4-a716-446655440000" \
  -H "x-timestamp: 2026-10-15T09:45:53.000Z" \
  -H "authorization: <signature>" \
  -d '{"coin":"usdt","chain":"tron","amount":"50","address":"TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT"}'

curl -X POST "https://sandbox-api.tender.cash/v1/api/payout/crypto" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payout-2026-10-15-0002" \
  -H "x-access-id: your-access-id-here" \
  -H "x-request-id: 6f1c2a4e-8b3d-4c5e-9f7a-1b2c3d4e5f60" \
  -H "x-timestamp: 2026-10-15T09:46:10.000Z" \
  -H "authorization: <signature>" \
  -d '{"coin":"usdt","chain":"tron","amount":"50","payoutAccountId":"66aec7de809b7f45c42a49f9"}'

{
  "status": "success",
  "message": "success",
  "data": {
    "_id": "66aec7de809b7f45c42a49f9",
    "type": "crypto",
    "status": "pending",
    "coin": "usdt",
    "chain": "tron",
    "address": "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT",
    "amount": "49.5",
    "totalAmount": "50",
    "usdValue": "49.5",
    "totalAmountUSD": "50",
    "fee": "0.5",
    "feeUSD": "0.5",
    "createdAt": "2026-10-15T09:20:15.650Z",
    "updatedAt": "2026-10-15T09:20:15.650Z"
  }
}

{
  "status": "error",
  "message": "Idempotency-Key was already used with a different request",
  "data": {}
}

Authorizations

authorization

string

header

required

Signed (HMAC) authentication. Required headers: x-access-id, x-request-id (UUID v4), x-timestamp (ISO 8601, must be within 5 minutes of server time), and authorization: the Base64 HMAC-SHA256 of the JSON string {"timeStamp":"","requestId":"","accessId":""} (keys in that order, no whitespace) using your access secret. The request body, method and path are not signed. The API key must be linked to an outlet.

Headers

authorization

string

required

x-timestamp

string<date-time>

required

ISO 8601 timestamp; must be within 5 minutes of server time

x-request-id

string<uuid>

required

A unique UUID v4 per request

x-access-id

string

required

Content-Type

enum<string>

required

Available options:

application/json

Idempotency-Key

string

required

Unique key for this payout, up to 200 characters. Same key and body within 24 hours replays the original response; a different body or a request still in flight returns 409. Scoped to your merchant account and this endpoint.

Maximum string length: 200

Body

application/json

Send address, payoutAccountId, or both (the saved account wins).

coin

string

required

Maximum string length: 500

Example:

"usdt"

chain

string

required

Maximum string length: 500

Example:

"tron"

amount

string

required

Must be worth at least $20 USD

Maximum string length: 500

Example:

"50"

address

string

Required if payoutAccountId is not sent

Maximum string length: 500

Example:

"TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT"

payoutAccountId

string

Active crypto payout account with the same chain and coin. Required if address is not sent.

Response

Payout created

status

string

required

Example:

"success"

message

string

required

Example:

"success"

data

object

required

Additional fields may be present; ignore fields you don't recognise.

Show child attributes

Payment

Transactions

System

Agents

Conversions

Payouts

Subwallets

Webhooks

On-ramp

Headers

Body

Idempotency

Response

Errors

Authorizations

Headers

Body

Response

​Headers

​Body

​Idempotency

​Response

​Errors

Authorizations

Headers

Body

Response

Headers

Body

Idempotency

Response

Errors