Getting Started

The Kyshi MoR API lets you collect payments, create virtual accounts, send transfers, manage subscriptions, and reconcile transactions from your own backend.

This Reference is to be used when you need exact methods, paths, parameters, request bodies, response examples, and code samples.

How The Reference Is Organized

SectionUse It For
TransactionsCard checkout, bank-transfer charges, verification, and transaction history.
Virtual AccountsCreating collection accounts, checking wallet balances, verifying credits, and test-mode credit simulation.
TransfersStandard bank payouts to saved or inline beneficiaries.
VA TransferNGN virtual-account-funded payouts to Nigerian bank accounts.
Payment LinksCustomer-specific hosted checkout links.
General Payment LinksReusable payment links where the customer checks out later.
PlansRecurring billing plan setup.
SubscriptionsCreating, charging, retrying, and managing recurring billing.
RatesPublic and business-specific exchange-rate lookup.

Recommended Integration Order

  1. Create or confirm your Kyshi business and integration settings in the dashboard.
  2. Get your test secret key.
  3. Configure your test webhook URL.
  4. Build your first flow using the relevant guide.
  5. Use this API Reference for exact endpoint details and Try It requests.
  6. Verify every payment or transfer from your server before updating your customer-facing state.
  7. Switch to your live key only after test-mode reconciliation is working.

Guides vs API Reference

Use Guides when you are deciding which flow to build and what order to call things in.

Use API Reference when you already know the endpoint and need exact fields, enum values, request examples, response shape, or generated language samples.