API Reference
ChangelogAPI ReferenceAPI keysSupportBlog

Initiate a charge

post
https://sandboxapi.fincra.com/checkout/charges

This API lets you charge using any of the available payment methods

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
📘

Note

  • The card parameter should be passed if type is card
  • The phone parameter should be passed if type is payattitudeor mobile_money.
Body Params
int32
required

The amount to charge the customer

string
required

The unique transaction reference identifies the transaction on your application. If you do not provide one, a unique transaction reference would be generated for the transaction.

string
enum
required

The currency in which the customer should be charged e.g ZAR, NGN etc.

string
enum
required

This payment method which can either be card, bank_transfer, mobile_money, payattitude or eft.

Allowed:
customer
object
required

The customer details

card
object

The details of the card you want to charge . This is required if "type" is card

string

The customer's payAttitude account phone number. This is required if "type" is payattitude or mobile_money

string

The description of the transaction

string
enum
Defaults to wallet

A settlement destination is the location where you want your payments to be settled. It could be wallet or a bank account.

Allowed:
string

The URL to redirect your customer when the transaction is complete.It's the url of your payment page you want your users to return to after 3ds authorization.

string
enum

This is required if type is mobile money

Allowed:
string

This is only required when initiating a cross currency charge

string

The URL to receive transaction notifications.

Headers
string
required
string
required
Responses

Updated 23 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 23 days ago