Create
Initiates a withdrawal to the specified destination address. The
payout is queued for immediate execution and enters queued
status; the executor dispatches it to the processor on its next
tick.
API key issued by the merchant dashboard. The key's environment (live/test) determines which data the caller can access. Permissions on the key control which endpoints are reachable.
In: header
Cryptocurrency code.
length <= 20Blockchain network of the payout asset (e.g. ethereum, solana, tron). Optional when the currency has an unambiguous network; required for multi-network tokens (USDT, USDC, ETH).
length <= 64Decimal string amount to send.
length <= 50Destination blockchain address.
length <= 256Memo/tag for chains that require it.
length <= 256Human-readable payout description.
length <= 1000Key-value metadata.
properties <= 50Empty Object
Idempotency key to prevent duplicate payouts.
length <= 255Response Body
const body = JSON.stringify({ "currency": "string", "amount": "string", "destination": "string"})fetch("https://dashboard.halfin.xyz/api/v1/payouts", { method: "POST", headers: { "Content-Type": "application/json" }, body}){
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"currency": "string",
"network": "string",
"amount": "string",
"recipient_amount": "string",
"merchant_debit_amount": "string",
"amount_in_base_currency": "string",
"network_fee": "string",
"fee_amount": "string",
"payout_fee_allocation": "customer",
"configured_network_fee_amount": "string",
"network_fee_allocation": "customer",
"destination": "string",
"destination_tag": "string",
"status": "queued",
"environment": "live",
"tx_hash": "string",
"idempotency_key": "string",
"description": "string",
"executable_at": "2019-08-24T14:15:22Z",
"completed_at": "2019-08-24T14:15:22Z",
"created_at": "2019-08-24T14:15:22Z"
},
"meta": {
"request_id": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
]
},
"meta": {
"request_id": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
]
},
"meta": {
"request_id": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
]
},
"meta": {
"request_id": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
]
},
"meta": {
"request_id": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
]
},
"meta": {
"request_id": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
]
},
"meta": {
"request_id": "string"
}
}