Get Payout

curl "https://sandbox-api.tender.cash/v1/api/payout/66aec7de809b7f45c42a49f9" \
  -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>"

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

{
  "status": "success",
  "message": "success",
  "data": {
    "_id": "6a45c1d2e4b0a1b2c3d4e5f9",
    "type": "fiat",
    "status": "processing",
    "coin": "USDC",
    "amount": "100",
    "withdrawalReference": "user-8821",
    "providerTransactionId": "abc123",
    "providerStatus": "pending_user_transfer_start",
    "createdAt": "2026-10-15T09:20:15.650Z",
    "updatedAt": "2026-10-15T09:24:10.220Z"
  }
}

{
  "status": "error",
  "message": "Withdrawal not Found",
  "data": {}
}

GET

api

payout

{id}

curl "https://sandbox-api.tender.cash/v1/api/payout/66aec7de809b7f45c42a49f9" \
  -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>"

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

{
  "status": "success",
  "message": "success",
  "data": {
    "_id": "6a45c1d2e4b0a1b2c3d4e5f9",
    "type": "fiat",
    "status": "processing",
    "coin": "USDC",
    "amount": "100",
    "withdrawalReference": "user-8821",
    "providerTransactionId": "abc123",
    "providerStatus": "pending_user_transfer_start",
    "createdAt": "2026-10-15T09:20:15.650Z",
    "updatedAt": "2026-10-15T09:24:10.220Z"
  }
}

{
  "status": "error",
  "message": "Withdrawal not Found",
  "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.

There are no payout webhooks. Poll this endpoint until status is completed or failed. All payout endpoints share a bucket of 10 requests per minute per merchant, so poll no more often than every 10 seconds. See Rate limits. For MoneyGram payouts, each call refreshes the status from MoneyGram. The raw MoneyGram status is returned in providerStatus, and status is set from it:

MoneyGram status	`status`
`completed`	`completed`
`error`, `expired`, `refunded`, `too_small`, `too_large`	`failed`
anything else (for example `pending_user_transfer_start`, `pending_anchor`)	`processing`

If MoneyGram can’t be reached, the last stored status is returned.

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"

Path parameters

string

required

The payout ID: _id from Payout Crypto, or id from Payout FiatExample: "66aec7de809b7f45c42a49f9"

Response

string

required

success on successExample: "success"

string

required

Human-readable result messageExample: "success"

object

required

The payout record

Show data properties

string

Payout IDExample: "66aec7de809b7f45c42a49f9"

string

crypto or fiatExample: "crypto"

string

pending (queued), processing (handed to the network or payout provider), completed or failedExample: "completed"

string

Coin paid outExample: "usdt"

string

Chain the payout is sent fromExample: "tron"

string

For crypto payouts, the net amount the recipient receives (requested amount minus the fee). For fiat payouts, the requested amount.Example: "49.5"

string

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

string

USD value of amountExample: "49.5"

string

USD value of totalAmountExample: "50"

string

Payout fee in coin (crypto payouts)Example: "0.5"

string

Payout fee in USD (crypto payouts)Example: "0.5"

string

Destination wallet address (crypto payouts)Example: "TQn9Y2khDD9JHTfVE5oB2h8BKWWM4LxKLT"

string

Saved payout account used, if any

string

On-chain transaction hash, once the payout has been broadcastExample: "7c1f0a9d3e5b..."

string

Recipient bank name (bank payouts)Example: "KUDA MICROFINANCE BANK"

string

Recipient bank code (bank payouts)Example: "090267"

string

Recipient account number (bank payouts)Example: "0123456789"

string

Recipient account name, when known (bank payouts)

string

The reference you sent with a fiat payoutExample: "user-8821"

string | null

MoneyGram transaction ID (MoneyGram payouts only)Example: "abc123"

string | null

Raw status last reported by MoneyGram, for example pending_user_transfer_start or completed (MoneyGram payouts only)Example: "pending_anchor"

string

ISO 8601 timestampExample: "2026-10-15T09:20:15.650Z"

string

ISO 8601 timestampExample: "2026-10-15T09:22:41.003Z"

string

Internal ID of the chain record (not expanded on this endpoint)

string

Internal ID of the coin record (not expanded on this endpoint)

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

Errors

HTTP	Message	Cause
404	`Withdrawal not Found`	No payout with this ID belongs to your merchant account
404	`Failed to fetch Transactions`	The ID is malformed

curl "https://sandbox-api.tender.cash/v1/api/payout/66aec7de809b7f45c42a49f9" \
  -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>"

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

{
  "status": "success",
  "message": "success",
  "data": {
    "_id": "6a45c1d2e4b0a1b2c3d4e5f9",
    "type": "fiat",
    "status": "processing",
    "coin": "USDC",
    "amount": "100",
    "withdrawalReference": "user-8821",
    "providerTransactionId": "abc123",
    "providerStatus": "pending_user_transfer_start",
    "createdAt": "2026-10-15T09:20:15.650Z",
    "updatedAt": "2026-10-15T09:24:10.220Z"
  }
}

{
  "status": "error",
  "message": "Withdrawal not Found",
  "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

Path Parameters

string

required

Payout ID

Response

Payout record

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

Path parameters

Response

Errors

Authorizations

Headers

Path Parameters

Response

​Headers

​Path parameters

​Response

​Errors

Authorizations

Headers

Path Parameters

Response

Headers

Path parameters

Response

Errors