OnLink
API reference

Confirm a withdrawal address with your administrator’s code

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.

POST
/v1/wallets/{id}/confirm

Authorization

partner-key
X-OnLink-Key<token>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/wallets/string/confirm" \  -H "Content-Type: application/json" \  -d '{    "otp": "123456"  }'
{  "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",  "nextStep": "Approved by your administrator. The address is now awaiting OnLink review and is NOT yet usable for delivery."}

Register a withdrawal address POST

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.

List your registered withdrawal addresses GET

Next Page