Create Token

Create and charge card tokens

/payments/create-token

POST https://seerbitapi.com/api/v2/payments/create-token

This endpoint allows you create a token

Headers

Name	Type	Description
Authorization*	String	Bearer Token

Request Body

Name	Type	Description
publickey*	String	merchant public key
amount*	String	amount to be charged
fullName*	String	Customer's fullname
mobileNumber*	String	Customer's phone number
currency*	String	The transaction currency (NGN, GHS, KES,XOF or USD). Country Default currency must be passed
country*	String	country should be set to Country default
paymentReference*	String	This is the unique identifier for a transaction, to be generated by merchant.
email*	String	customer emails
paymentType*	String	paymentType should be set to CARD
cardNumber*	String	customer card number
expiryMonth*	String	customer card expiry month (e.g 01,02,11)
expiryYear*	String	customer card expiry month (e.g 23,24,25)
cvv*	String	customer card cvv
pin*	String	customer card pin
redirectUrl*	String	a page to be redirect to after successful payment

cURL

curl --location 'https://seerbitapi.com/api/v2/payments/create-token' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ENCRYPTED_KEY' \
--data-raw '{
    "publicKey": "YOUR_PUBLIC_KEY",
    "amount": "50",
    "fullName": "Jane Smith",
    "mobileNumber": "03447522256",
    "redirectUrl":"http://example.com",
    "currency": "NGN",
    "country": "NG",
    "paymentReference": "204g4de74a7ib0j18dg6bi521aiaejf4",
    "email": "[e-mail]",
    "paymentType": "CARD",
    "cardNumber": "512348984984988883",
    "expiryMonth": "01",
    "expiryYear": "25",
    "cvv":"000",
    "pin":"2222" 
}'

200: OK Transaction is pending

{
    "status": "SUCCESS",
    "data": {
        "code": "S20",
        "message": "Transaction is pending",
        "payments": {
            "paymentReference": "{{paymentReference}}",
            "linkingReference": "SEERBIT60416746746373661414266005",
            "redirectUrl": "https://seerbitapi.com/50E84E82C25D"
        }
    }
}