Create a Tokenized Charge

Create a tokenized charge with a card or bank account token. We recommend that you read our overview before you proceed with your integration.

Body Params
string
required
Defaults to flw-t1nf-f9b3bf384cd30d6fca42b6df9d27bd2f-m03k

This is the card or bank account token. Refer to the Card tokenization or Direct debit (E-mandate) section of the documentation to learn more about retrieving the token.

string
required
Defaults to [email protected]

This is the email address of the customer. Note: This has to be the exact email address passed during the initial charge.

string
required
Defaults to NGN

This is the specified currency to charge the card in, It can be NGN, GHS, KES, UGX, TZS, USD etc.

string
required
Defaults to NG

This is the ISO country code of the merchant e.g. NG, GH, KE etc.

int32
required
Defaults to 2000

This is the amount to be charged

string
required
Defaults to tokenized-c-001

This is a unique reference, unique to the particular transaction being carried out.

string
required
Defaults to https://webhook.site/3ed41e38-2c79-4c79-b455-97398730866c

This is the url your customer's will be redirected to after completing payment.

string
Defaults to Yemi

This is the first name of the card holder or the customer

string
Defaults to Desola

This is the last name of the card holder or the customer

float
Defaults to null

IP - Internet Protocol. This represents the IP address of where the transaction is being carried out.

string
Defaults to Sample tokenized charge

This is a custom description added by the merchant

string
Defaults to 62wd23423rq324323qew1

This is the fingerpringt for the device being used. It can be generated using a library on whatever platform is being used

int32
Defaults to 3974

This is the ID of the plan you want to subscribe to. It is returned in the call to create a payment plan as data.id

subaccounts
array of objects

This is an array of objects containing the subaccount IDs to split the payment into. Subaccount ID's are returned in the call to create a subaccount as data.subaccount_id

subaccounts
boolean
Defaults to false

Pass this value as true to preauthorize a tokenized charge

Headers
string
required
Defaults to Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X

Pass your secret key as a bearer token on the request header to authorize this call

Responses

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