Transfers
Create Transfer
Move funds to another account.
Modified at Apr 28, 2026, 05:38 AM UTC
POST/api/transfertransfer.create
Use this request when your integration needs to move funds to another account.
Send an Idempotency-Key with every transfer request. Reusing the same key with the same body returns the original result; reusing it with a different body returns a conflict.
Request
curl "https://cekceir.online/api/transfer" \
-X POST \
-H "Authorization: Bearer <api_key>" \
-H "Content-Type: application/json" \
-d '{
"Idempotency-Key": "example",
"receiver": 1,
"amount": "example",
"description": "example"
}'Request Fields
| Field | Type | Required | Description |
|---|---|---|---|
| Authorization | header string | Yes | Bearer token header in the format Bearer <api_key>. |
| Idempotency-Key | header UUID v4 | Yes | Unique key for safe transfer retries. |
| receiver | number | Yes | Receiver user ID. |
| amount | positive integer | Yes | Transfer amount. |
| description | string | No | Optional transfer note. |
Success Response
{ "data": { "transferId": 501, "transactionId": 9001, "senderLedgerId": 701, "receiverLedgerId": 702 }, "replayed": false}Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
| data.transferId | number | Yes | Created transfer ID. |
| data.transactionId | number | Yes | Wallet transaction ID for the transfer. |
| data.senderLedgerId | number | Yes | Sender ledger mutation ID. |
| data.receiverLedgerId | number | Yes | Receiver ledger mutation ID. |
| replayed | boolean | Yes | true when the response was returned from a previous idempotent request. |