Withdrawals
Payouts from a Korven wallet to a bank or mobile-money destination.
Overview
Withdrawals settle within one banking day for domestic destinations. Every state change emits a webhook.
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/withdrawals | Create a withdrawal. |
| GET | /v1/withdrawals/{id} | Retrieve. |
| GET | /v1/withdrawals | List with filters. |
POST /v1/withdrawals
POST/v1/withdrawals
Create a withdrawal.
| Field | Type | Description |
|---|---|---|
amountreq | int | Minor units. |
currencyreq | 'HTG' | 'USD' | ISO-4217. |
beneficiaryreq | beneficiary id | Verified recipient. |
memo | string | Appears on the recipient's statement. |
GET /v1/withdrawals/{id}
GET/v1/withdrawals/{id}
Retrieve.
GET /v1/withdrawals
GET/v1/withdrawals
List with filters.
Lifecycle
queued → processing → in_flight → succeeded
└──▶ failed (reason on `failure_code`)