Initiate a charge

post

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

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

amount

int32

required

The amount to charge the customer

reference

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.

currency

string

enum

required

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

type

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

phone

string

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

description

string

The description of the transaction

settlementDestination

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:

callbackUrl

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.

operator

string

enum

This is required if type is mobile money

Allowed:

quoteReference

string

This is only required when initiating a cross currency charge

webhookUrl

string

The URL to receive transaction notifications.

Headers

api-key

string

required

x-business-id

string

required

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400