Overview

Before capturing a payment, you must first initialize a payment session with customer and transaction details. The initialization process:

  1. Validates the payment request

  2. Creates a session identifier

  3. Sets up the appropriate payment flow

  4. Returns payment session details

Supported Payment Methods

Cards

Credit and Debit cards[Visa & Mastercard]

Bank Transfers

Direct bank transfers.

  • NGN bank accounts.

  • International wires.

  • ACH transfers.

Stablecoins

Cryptocurrency Stablecoins

Binance Pay

Direct Binance integration.

  • Multiple currencies.

  • Instant settlement.

Interac e-Transfer

Canadian bank transfers via Interac.

  • Email money transfer.

  • Instant deposits.

Mobile Money

Coming soon!

  • Multiple providers.

  • Regional support.

Universal Parameters

These parameters are required for all payment initializations regardless of the payment method:

amount
integer
required

Payment amount in minor units (e.g., cents, kobo)

  • Minimum: 100

  • Must be positive integer

  • Example: 10000 = $100.00 USD

currency
string
required

Three-letter ISO currency code

  • Supported: NGN, USD, CAD

  • Must match payment method

  • Example: “USD”

customer
object
required

Customer information object

description
string
required

Payment description

  • Maximum length: 200 characters

  • Will appear on statements

reference
string
required

Unique transaction reference

  • Must be unique per transaction

  • Maximum length: 50 characters

payment_method
object
required

Payment method details

  • Type required

  • Additional fields vary by method

metadata
object

Optional additional data

  • Maximum size: 10KB

  • Nested objects allowed

Required Headers

HeaderDescriptionExample
AuthorizationYour API keyBearer sk_test_abc123...
Content-TypeRequest content typeapplication/json

Never expose your API key in client-side code. Always make API calls from your server.

Basic Flow

1

Initialize Payment

Create payment session with customer and transaction details

2

Handle Authentication

Complete any required authentication steps (3DS, OTP, etc.)

3

Capture Payment

Finalize the payment after successful authentication

4

Handle Response

Process success/failure and update your system

Method-Specific Guides

For detailed implementation steps for each payment method, see:

Need Help?