Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kora Virtual Bank Accounts API

Dedicated NGN and USD virtual bank accounts.

Kora Virtual Bank Accounts API is one of 7 APIs that Kora publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Virtual Bank Accounts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 3 operations across 3 paths, and defines 3 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.korapay.com/merchant/api/v1.

3 operations 3 paths 3 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://api.korapay.com/merchant/api/v1
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Kora Virtual Bank Accounts API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (secretKeyAuth). It accepts HTTP bearer tokens (publicKeyAuth). By default, every request must be authenticated.

  • secretKeyAuth — Secret API key passed as Authorization: Bearer sk.... Required for server-side and financial operations (payouts, balances, virtual bank accounts, refunds, con…
  • publicKeyAuth — Public API key (pk...) used from client-side code to initiate charges. Cannot access financial data.

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Virtual Bank Accounts 3

Dedicated NGN and USD virtual bank accounts.

POST
/virtual-bank-account
Create a virtual bank account
createVirtualBankAccount body → 200401
GET
/virtual-bank-account/transactions
Fetch virtual bank account transactions
listVirtualBankAccountTransactions 5 params → 200401
GET
/virtual-bank-account/{accountReference}
Retrieve a virtual bank account
getVirtualBankAccount 1 param → 200401404

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are VirtualBankAccountInput (6 properties), ErrorResponse (3 properties), VirtualBankAccount (3 properties). Each schema is shown below with its type and property counts.

VirtualBankAccount
object
3 properties
VirtualBankAccountInput
object
6 properties 6 required
ErrorResponse
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

korapay-virtual-bank-accounts-api-openapi.yml Raw ↑

Other APIs Kora publishes across the network.

Kora Balances API
Kora Charges API
Kora Currency Conversion API
Kora Misc API
Kora Payouts API
Kora Refunds API