Back to home
INTEGRATION
PAYMENT FEATURES
AFTER PAYMENT
Card Tokenise and Charge
The Card Tokenize and Charge API allows you to charge a tokenized payment method.
After the initial successful payment with a customer's card, it is possible to store their card authorization for future transactions.Merchants that are not PCI compliant can leverage our Simple Checkout or our Sdk Libraries to store the card token securely, which can be used for future charges.
Create Card Token
To commence the first charge, it is required to follow local regulations that necessitate users to authenticate their card through a two-factor authentication process in the initial charge transaction. This is done to verify that the card is valid and it belongs to the user inititializing the transaction and that it can be charged for subsequent transactions. Additionally a minimum amount of NGN 50.00, GHS 1, KES 1, or USD 0.50 is required to be passed in the request body for the first charge.
POST
https://seerbitapi.com/api/v2/payments/create-token
Request Sample
The code snippet below shows an example response for creating a card token
Response Sample
The code snippet below shows an example response for creating a card token
Parameter Description
Name
Type
Description
Required?
public key
string
public key - this can be copied from the seerbit dashboard
Yes
amount
string
amount to be charged
Yes
fullName
string
customer's full name
Yes
mobileNumber
string
customer's mobile number
Yes
currency
string
currency in which you want to charge
Yes
country
string
country of the business or currency
Yes
email
string
customer's email
Yes
paymentType
string
pament type should be set to CARD
Yes
cardNumber
string
debit or credit card number
Yes
expiryMonth
string
debit or credit card expiry month. E.g 12 means december
Yes
expiryYear
string
debit or credit card exiry year. E.g 23 means 2023
Yes
cvv
string
digits at the back of the card
Yes
pin
string
card pin
Yes
redirectUrl
string
page to be redirected to after successful authentication
Yes
Name
Type
Description
Required?
public Key
string
public key - this can be copied from the seerbit dashboard
Yes
amount
string
amount to be charged
Yes
fullname
string
customer's full name
Yes
mobile number
string
customer's mobile number
Yes
currency
string
currency in which you want to charge
Yes
country
string
country of the business or currency
Yes
email
string
customer's email
Yes
paymentType
string
pament type should be set to CARD
Yes
cardNumber
string
debit or credit card number
Yes
expiryMonth
string
debit or credit card expiry month. E.g 12 means december
Yes
expiryYear
string
debit or credit card exiry year. E.g 23 means 2023
Yes
cvv
string
customer's digits at the back of the card
Yes
pin
string
card pin
Yes
redirectURL
string
page to be redirected to after successful authentication
Yes
Get Card Authorization Code
After the first sucessful transaction, you can query the transaction with the payment reference endpoint to confirm the status of transaction. The queried payment reference retunrs the authorizationCode that will be used for subsequent charges. Below is a sample response.
GET
https://seerbitapi.com/api/v3/payments/query/{{paymentReference}}
Response Sample
Parameter Description
Name
Description
authorizationCode
authorizartion code to charge a customer
customerId
unique customer identification
maskedPan
masked card number
Charge Authorization Token
To charge a card token, simply send the authorizationCode along with the amount to be charged using the charge authorization api
POST
https://seerbitapi.com/api/v2/payments/charge-token
Request Sample
The code snippet below shows an example request for charging a token
Response Sample
The code snippet below shows an example response for charging a token
Bulk Charge Token
POST
https://seerbitapi.com/api/v2/payments/bulk-tokenize-charge
Request Sample
The code snippet below shows an example response for bulk charging a token
Response Sample
The code snippet below shows an example response for bulk charging a token
Query Bulk Charge with BacthId
GET
https://seerbitapi.com/api/v2/payments/bulk-tokenize-charge-search?batchId={{batchId}}
Response Sample
The code snippet below shows an example response for querying a bulkchargeToken with the batchId
Need something else?
If you have any questions or need general help, visit our support page
Signup for developer update
You can unsubscribe at any time. Read our privacy policy.