Convert USD to KES

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.

Authorization

partner-key

X-OnLink-Key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

from*string

The currency you convert from. Only USD is supported.

to*string

The currency you receive. Only KES is supported.

amount*string

The amount of from to convert, as a decimal string with at most 2 decimal places.

partnerReference*string

Your own reference for this conversion, stored for your records and returned on reads.

idempotencyKey*string

Makes the create safe to retry: the same key with the same body returns the same conversion; the same key with a different body is refused IDEMPOTENCY_KEY_REUSED (422). 8 to 64 characters from A-Z, a-z, 0-9, _ and -.

Match^[A-Za-z0-9_-]{8,64}$

Response Body

`application/json`

curl -X POST "https://example.com/v1/conversions" \  -H "Content-Type: application/json" \  -d '{    "from": "USD",    "to": "KES",    "amount": "100.00",    "partnerReference": "payout-run-2026-10-24",    "idempotencyKey": "cnv-2026-10-24-0001"  }'

{  "id": "c0a8012e-7b1a-4c39-9d3e-2f5c8a1b6d40",  "status": "processing"}

Convert USD to KES

Authorization

Request Body

Response Body

202application/json

404application/json

409application/json

422application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`