To make API calls on SeerBit, you will be required to pass a bearer token. To generate a token simply pass your pubic and secret key to rceive a token to process further API calls.
key required | string This consist of the PrivateKey and the publicKey separated with a '.' in the middle(eg:{privateKey.publicKey} |
{- "key": "SBTESTSECK_9Cb8dbqR5Rc2JwZaa77P5QYHzQaeGUcrkEMD1dEi.SBTESTPUBK_9sN3TuLgW6a9redEfY48cKKkUa09Pz2u"
}
{- "status": "SUCCESS",
- "data": {
- "code": "00",
- "EncrytedSecKey": {
- "encryptedKey": "oAX1OeAlwNt9BI5VEwBLlxtWgL2WaLT9kTc4EMaaZgXMfdhHXaqqVgapnQSOO4OZM2oLRPtqjJzwNLEEGqFSvam8MFz06U4fl/5TVwfWLMsRHq4mML9ExIaXRVn3bVm8"
}, - "message": "Successful"
}
}
This is used to ensure the request payload has not been altered
publicKey required | string This is the merchant public key. |
amount required | string This is the amount to be paid. |
currency required | string This is the currency the transaction is to be carried out in. |
country required | string This is the country from which the transaction is been carried out from |
paymentReference required | string This is the unique identifier for a transaction, to be generated by merchant. |
email required | string This is the email of the customer. |
productId required | string This is the product id entered by the merchant. |
productDescription required | string This is the product description supplied by the merchant. |
callbackUrl required | string |
{- "publicKey": "SBTESTPUBK_9sN3TuLgW6a9redEfY48cKKkUa09Pz2u",
- "amount": "10.00",
- "currency": "NGN",
- "country": "NG",
- "paymentReference": "3791090233047WZ73QN",
- "email": "mamadou.diouf@intouchgroup.net",
- "productId": "15013",
- "productDescription": "touch badge",
}
{- "status": "SUCCESS",
- "data": {
- "code": "00",
- "message": "Successful",
- "hash": {
- "hash": "ae18321b005df1b9f16ca8590425e213366da3ab1d8aa2fa30d78dfa6ab9850a"
}
}
}
SeerBit Checkout Standard Initialises a transaction from merchants server to generate a payment link which redirects your customers to a page to make payment and after payment has been made the customer is redirected back to the merchants website.
publicKey required | string This is the merchant public key. |
amount required | string This is the amount to be paid. |
currency required | string This is the currency the transaction is to be carried out in. |
country required | string This is the country from which the transaction is been carried out from |
paymentReference required | string This is the unique identifier for a transaction, to be generated by merchant. |
email required | string This is the email of the customer. |
productId required | string This is the product id entered by the merchant. |
productDescription required | string This is the product description supplied by the merchant. |
callbackUrl required | string This is the callback url supplied by the merchant so that Seerbit can redirect back to it . |
hash required | string This is the hash of the concatenated string for payment. Check hash module for more clarification. |
hashType required | string This refers to the hash type used in generating the hash |
{- "publicKey": "SBTESTPUBK_9sN3TuLgW6a9redEfY48cKKkUa09Pz2u",
- "amount": "10.00",
- "currency": "NGN",
- "country": "NG",
- "paymentReference": "P791090233047WZ73QN",
- "email": "mamadou.diouf@intouchgroup.net",
- "productId": "15013",
- "productDescription": "touch badge",
- "hash": "cfb5464ea21cce315ea72fb28f7ea45c4b61c443783eeff82dea98e57d445e15",
- "hashType": "sha256"
}
{- "status": "SUCCESS",
- "data": {
- "code": "00",
- "payments": {
- "paymentStatus": "08"
}, - "message": "Successful"
}
}
Create an order before payment
{- "email": "test@mvaa.com",
- "publicKey": "SBTESTPUBK_9sN3TuLgW6a9redEfY48cKKkUa09Pz2u",
- "paymentReference": "2PPTG108Q13432E29P23R5L6W93I9",
- "fullName": "",
- "orderType": "BULK_BULK",
- "mobileNumber": "",
- "country": "NG",
- "currency": "NGN",
- "amount": "250.00",
- "orders": [
- {
- "orderId": "1235567-113227878-64332q",
- "currency": "NGN",
- "amount": "125.00",
- "productId": "0008162",
- "productDescription": "FRSC PLATE NUMBER"
}, - {
- "orderId": "2211567-2230578-754332",
- "currency": "NGN",
- "amount": "125.00",
- "productId": "4030018",
- "productDescription": "WEIGHING AND ADMIN CHARGES"
}
]
}
{- "status": "SUCCESS",
- "data": {
- "code": "00",
- "payments": {
- "amount": 250,
- "paymentReference": "2PPTG108QL13432E29P23R5L6W93I9",
- "paymentStatus": "08",
}, - "message": "Successful"
}
}