Overview
Introduction
Korven One is a modern financial operating system for Haiti and the Caribbean. One API to accept payments, hold funds, move money, and settle across banks and wallets.
Korven One exposes a small set of REST resources — payments, wallets, transfers, withdrawals, remittances — with predictable JSON, deterministic error codes, and signed webhooks. You can integrate a full checkout in an afternoon and add treasury or BaaS workflows later without rewriting anything.
What you can build
Merchant payments
Accept card, mobile wallet, and bank transfers with hosted checkout or your own UI.
Wallet infrastructure
Issue balances, ledger every cent, and expose real-time transaction history.
Payment links
Generate shareable, reusable payment URLs — no code required for the seller.
Remittances
Send USD → HTG across compliant corridors with lifecycle tracking end-to-end.
Settlement engine
Batch payouts to your bank with reconciled statements and audit-grade receipts.
Business APIs
Payroll, invoicing, tuition and utility rails built on the same core primitives.
Architecture
Every request hits the same versioned base URL and is authenticated by an API key that is scoped to either the sandbox or the live environment. Writes are idempotent, reads are cursor-paginated, and every state change fans out as a signed webhook event.
Client ──HTTPS──▶ api.korvenone.com/v1
│
├── Auth (Bearer key, scope + env check)
├── Idempotency store (24h)
├── Core ledger (double-entry)
└── Event bus ──▶ signed webhook delivery
Core primitives
| Field | Type | Description |
|---|---|---|
Payment | resource | A single money-in intent from a customer. |
Customer | resource | A stable identifier for an end-buyer. |
Wallet | resource | A merchant balance denominated in HTG or USD. |
Transfer | resource | Movement of funds between wallets you control. |
Withdrawal | resource | Payout from a wallet to a bank or mobile-money account. |
Settlement | resource | Aggregated batch payout with a reconciled statement. |
Event | resource | An immutable record of a state change, streamed via webhook. |