Register a withdrawal address
Creates the address in pending_partner_approval and emails a 6-digit code to a registered administrator. The address is not usable until your administrator confirms the code and OnLink approves it. Re-registering the same address is idempotent: the existing registration is returned and no second row is created. If that registration is still awaiting your administrator and its code is no longer usable (expired, or cancelled after too many incorrect attempts), re-registering re-issues a fresh code — this is how you recover such an address. A code that is still live is never replaced, and no code is issued once the address has moved past your administrator’s approval.
Authorization
partner-key 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
curl -X POST "https://example.com/v1/wallets" \ -H "Content-Type: application/json" \ -d '{ "chain": "tron", "asset": "USDT", "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" }'{ "walletId": "b8e4d1c7-2f39-4a05-8d6b-1c2e3f4a5b60", "chain": "tron", "asset": "USDT", "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "label": "Settlement wallet — Tron", "status": "pending_partner_approval", "screeningStatus": "pending", "createdAt": "2026-08-31T09:30:00.000Z", "approvalSentTo": "o•••@yourcompany.com", "nextStep": "A 6-digit approval code was emailed to a registered administrator. Confirm with POST /v1/wallets/{id}/confirm. The address is NOT usable until OnLink also approves it."}Your balances GET
The KES account you hold with us and its available balance. USDT is added when the ledger ships.
Confirm a withdrawal address with your administrator’s code POST
Moves the address to pending_onlink_approval — not to active. OnLink approves every withdrawal address as well, so a correct code alone does not make an address usable.