Standard Checkout

You can also integrate through the standard checkout approach, which allows you to generate a link for a particular transaction. This is done by calling our initialize transaction API which generates a checkout link, your customers can click on and then make payment.

How to Integrate

When your customer clicks on the checkout button, make a call to our initialize transaction API. We authenticate this call, by a Bearer Token, passed alongside the request. To see how to get you Bearer Token, click here getting my SeerBit Bearer Token. You can pass the customer details such as email during this call. SeerBit validates your request and sends back a checkout link to complete payment.

Note that in cases where you require your customers to bear the charge for a transaction, the agreed charge should be added to the transaction amount. This charge will be deducted after the transaction is completed and the merchant settled the transaction amount.

Authentication
Request Body
Response
Authentication
-X POST
https://seerbitapi.com/api/v2/payments
-H 'Content-Type: application/json'
-H 'Authorization: Bearer {token}
Request Body
{
"publicKey":"merchant publickey",
"amount":"5000.00",
"currency":"NGN",
"country":"NG",
"paymentReference":"643108207792124616573324",
"email":"[email protected]",
"productId":"64310880-2708933-427",
"productDescription":"product description",
"callbackUrl":"http:yourwebsite.com",
"hash":"e234a6a5c2e856224933ad6942e1732e64efb314d1402b469b4a71377991a607",
"hashType":"sha256"
}
Response
{
"status": "SUCCESS",
"data": {
"code": "00",
"payments": {
"redirectLink": "http://checkout.com/#/?mid=merchantpublickey&paymentReference=643108207792124616573324",
"paymentStatus": "08"
},
"message": "Successful"
}
}

Merchant is expected to use the redirect link returned in the repsonse to navigate to the seerBit checkout modal to continue the transaction

post
Initialize Transaction

https://seerbitapi.com/api/v2/payments
Request
Response
Request
Headers
Content-Type
required
string
application/json
Authorization
required
string
Bearer {token}
Body Parameters
publicKey
required
string
your publickey can be obtained from your merchant account's settings page
amount
required
string
amount to be paid
currency
required
string
currency to perform transaction
country
required
string
country the customer is performing transaction
paymentReference
required
string
Unique payment reference/identifier, to be supplied by merchant
email
required
string
customer email address
productId
required
string
unique identification number of product, To be supplied by merchant
productDescription
required
string
transaction narration
redirectLink
optional
string
url to redirect to
callbackUrl
required
string
merchant url to redirect to after transaction
hash
required
string
hash of selected string from request payload
hashType
required
string
sha256
Response
200: OK
{
"status": "SUCCESS",
"data": {
"code": "00",
"payments": {
"redirectLink": "http://checkout-seerbit.surge.sh/#/?mid=merchantpublickey&paymentReference=643108207792124616573324",
"paymentStatus": "08"
},
"message": "Successful"
}
}