OnLink
API reference

Confirm a money-movement instruction

Verifies the code sent to your registered confirmation contact (or pushed to your webhook as confirmation.code_issued) and, once correct, hands the instruction off for execution. The response reflects the instruction status immediately after this call (confirmed) — poll GET /v1/transfers/:id for what happens next.

POST
/v1/confirmations/{id}

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

application/json

application/json

curl -X POST "https://example.com/v1/confirmations/string" \  -H "Content-Type: application/json" \  -d '{    "code": "482913"  }'
{  "confirmationId": "df9f1e6a-0000-4000-8000-000000000030",  "subjectType": "transfer",  "subjectId": "bd9f1e6a-0000-4000-8000-000000000010",  "status": "confirmed",  "verifiedAt": "2026-09-11T00:02:00.000Z"}

Resend the confirmation code POST

Re-issues the code on the shared escalating resend ladder. Refused while the previous code is still within its cooldown window. The new code goes wherever your account delivers codes NOW, which may differ from where the first code went if OnLink changed the setting since. The response carries webhookDelivery only when the new code was pushed to your webhook.

Convert USD to KES POST

Debits the USD from your USD account and credits the KES to your KES account, asynchronously. Poll GET /v1/conversions/:id or wait for conversion.settled or conversion.failed. If the exchange cannot be completed after your USD was debited, the USD is returned to you and the conversion ends failed with the reason. No confirmation code: both accounts are your own.