OnLink
API reference

Send USDT from your wallet to a registered destination

Validates the destination against your wallet allowlist (only an active wallet may receive value), checks the amount against our minimum and your caps, then writes the instruction and sends a confirmation code to your registered person. Nothing reaches the chain until that code is verified via POST /v1/confirmations/:id.

POST
/v1/usdt/sends

Authorization

partner-key
X-OnLink-Key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/usdt/sends" \  -H "Content-Type: application/json" \  -d '{    "destinationWalletId": "fa9f1e6a-0000-4000-8000-000000000050",    "usdtAmount": "25.500000",    "idempotencyKey": "send-2026-09-16-000123"  }'
{  "id": "ed9f1e6a-0000-4000-8000-000000000040",  "status": "awaiting_confirmation",  "destinationWalletId": "fa9f1e6a-0000-4000-8000-000000000050",  "usdtAmount": "25.500000",  "partnerReference": "PS-SEND-000123",  "failureReason": "USDT_SEND_INSUFFICIENT_LEDGER_BALANCE",  "createdAt": "2026-09-16T00:00:00.000Z",  "confirmedAt": "2026-09-16T00:02:00.000Z",  "confirmation": {    "id": "df9f1e6a-0000-4000-8000-000000000030",    "channel": "email",    "deliveredTo": "o***@partner.co.ke",    "expiresAt": "2026-09-11T00:15:00.000Z",    "resendAvailableAt": "2026-09-11T00:00:15.000Z"  }}

Send money from your KES account POST

Validates the destination, verifies the beneficiary name where the rail supports it, checks your caps and balance, then writes the instruction and sends a confirmation code to your registered person. Nothing reaches the bank until that code is verified via POST /v1/confirmations/:id.

Errors

One error envelope for every refusal, the codes you branch on, and what is worth retrying.