Seerbit Release Notes
17 days ago
Callback URL introduced for inline script V1

We understand how important it is for your customers to be redirected to a customised page where you can display a transaction receipt on your application after every transaction, so we have included a callback URL field in the payload when using our inline script.


If you provide a callback URL we will redirect back to it after every transaction. Kindly ensure you confirm the status of the transaction by calling our status confirmation endpoint using the reference sent back as query string parameter in the URL. See guide Here


Here’s a sample of a callback URL after redirection with query string parameters:


https://merchanturl.com?linkingreference=F641426531573992889243&code=00&message=Successful&reference=IHrE1573992870916


Here’s a sample of the payload:


{
"tranref": "Pg5" + new Date().getTime(), 
"currency": "NGN"
"description": "test",
"country": "NG",
"amount": "1.00",
"clientappcode": "app1", 
"callbackurl": "http://youdomain.com", 
"public_key": "tNUFstIHrE",
"product_id": "my unique id", 
"full_name": "test test",
"email": "test@emaildomain.com",
"mobile_no": "08011111111",
}


Also, take note of these guides:


You have to ensure the callback URL is available on the WWW and not localhost, as we will not redirect to localhost.

Ensure your URL doesn’t require some form of authentication, else, your customer won’t be redirected to the intended page.

2 months ago
Improved transaction details

Hello! we have introduced an alternative way of referencing your transactions. We've added an alternative transaction/product reference field. You can send your ISBN, SKU or any other unique reference for your product or service as an alternative reference when initialising a transaction.

This field is named productId and should be sent in every request payload for each transaction. See example payload below:

{
"publicKey":"cqjphzlAEl", //replace this with your own public key
"amount":"10000.00",
"currency":"NGN",
"country":"NG",
"paymentReference":"5fgj77tx867563777",
"email":"test@yourdomain.com",
"productId":"Unique product id",
"productDescription":"Product description",
"callbackUrl":"http://yourdomain.com",
"hash":"3af7fbd7de08cad92c83e178c827cc7e0",
"hashType":"sha256"
}


The new field will be displayed on each transaction on your dashboard as Product ID and you can also search transactions using this field.



2 months ago
Seerbit V1.0.1 release

Hello! Great news: we've released a new version that introduces some new upgrades to enhance integration experience. 

You can now initialise a transaction via API call using our standard checkout option. You can see the full documentation Here

Verify a transaction status before giving value to your customers. All that is required is the transaction reference to be added as a parameter in a GET request.

https://staging.seerbitapigateway.com/sbt/api/card/v1/get/transaction/status/{transaction-reference}

Bearer token would no longer be required for authentication but an AES encrypted private key value is now required to be sent in Header requests.

Request payload for checkout standard has to be hashed using SHA256 algorithm.

Transaction request and response payload has been modified slightly to accommodate more fields, to strengthen transaction security and add more details to each transaction.

{
"publicKey":"cqjphzlAEl",
"amount":"100",
"currency":"NGN",
"country":"NG",
"paymentReference":"5fgj77tx867563777",
"email":"customer-email@email-server.com",
"productId":"lbs200978ng",
"productDescription":"Laced Brown Shoe",
"callbackUrl":"http://www.yourwebsite.com/callback-path",
"hash":"3af7fbd7de08cad92c83e178c827cc7e06198279691e",
"hashType":"sha256"
}

As stated above, productId, hash, and hashType has been added as a field for each transaction request.


Webhook response payload has been updated with new data

{
"name":"John Doe",
"amount":"100.00",
"mobile":"09060007388",
"reference":"x30",
"status":"APPROVED",
"generatedAt":"2019:08:06 10:28:12",
"hashvalue":"08hgtt657fgvhvhjgj9708ho_+89uhk khvjv"
}

We've also updated the response payload of the success callback function

{
"status": "SUCCESS",
"data": {
"code": "00",
"payments": {
"reference": "lAEl1569141936732",
"linkingreference": ?F132338911569141957013?,
"callbackurl": "https://checkout.seerbit.com"
},
"message": "Approved by Financial Institution"
}
}

8 months ago
We've got Release Notes!

Hello! Huge news!  We're excited to let you know that we've started publishing our product updates in a public changelog so you're always up-to-date! 

Keep an eye on this page for new features improvements and bug fixes that are made on our SeerBit applications and services.