Initiate Checkout

post

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

Body Params

currency

string

enum

required

Defaults to NGN

The currency in which the customer should be charged. (NGN, KES, GHS, UGX,XAF,XOF)

amount

int32

required

Defaults to 1500

The amount to charge the customer

customer

object

required

The customer details

paymentMethods

array of strings

Defaults to card,bank_transfer

The payment method you want to make available to your customers . e.g bank_transfer, card and payAttitude

paymentMethods

reference

string

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.

feeBearer

string

enum

Defaults to business

Decide who will bear the transaction fees.

Allowed:

settlementDestination

string

enum

A settlement destination is the location where you want your payments to be settled. The settlement destination is your Fincra wallet by default.

Allowed:

redirectUrl

string

Defaults to https://yoursite.com/redirect-destination

The URL to redirect your customer when the transaction is complete.

defaultPaymentMethod

string

enum

The Payment method that should be active by default on the checkout page

Allowed:

quoteReference

string

This is only required when initiating a cross currency checkout

Headers

x-pub-key

string

Your public key. This can be found in the settings page of your portal

x-business-id

string

The unique Identifier of the parent business

Responses

Language

Credentials

Header

Response

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

application/json

200200

400400