Bank Account Payment

Accept payments directly from your customers local bank account through a direct bank debit payment channel.
How it works
1.To initiate a direct bank debit payment, make a request to the account payments service with the payments/initiates endpoint.
2.When the request is made you are expected to get a pending response.
3.The response from banks differ, some banks will return with a redirect url while others will not.
4.When a redirect url is returned, you are expected to redirect to the link supplied which will take the customer to the bank page. On this page, customer is expected to enter the OTP sent to their registered phone number or email with the bank. After the OTP is submitted, SeerBit redirects back to the redirect url supplied by the merchant.
5.When the redirect url is not returned, the transaction would be awaiting validation.
6.To validate the transaction the customer gets an OTP( one time password) via the registered number with the bank or via email.
7.​Use the OTP entered by the customer and reference to call the payments/validate endpoint to complete the transaction.​
8.​Verify the payment​
Authentication
Request Body
Response Body
1
curl -X POST
2
https://seerbitapi.com/api/v2/payments/initiates
3
-H 'Content-Type: application/json' 
4
-H 'Authorization: Bearer {token}
Copied!
1
{
2
	"publicKey":"merchantPublicKey",
3
	"amount":"2000.00",
4
	"fee":"10",
5
	"fullName":"John Doe",
6
	"mobileNumber":"08037456590",
7
	"currency":"NGN",
8
	"country":"NG",
9
	"paymentReference":"UYTRE234566677RDFGFDDSS",
10
	"email":"[email protected]",
11
	"productId":"Foods",
12
	"productDescription":"Uba Account Transaction ",
13
	"clientAppCode":"kpp64",
14
	"redirectUrl":"https://checkout.seerbit.com",
15
	"deviceType":"Apple Laptop",
16
  "sourceIP":"127.0.0.1:3456",
17
  "accountName":"John S Doe",
18
  "accountNumber":"1234567890",
19
  "bankCode":"033",
20
  "bvn":"12345678901",
21
  "dateOfBirth":"04011984",
22
  "retry":"false",
23
	"invoiceNumber":"1234567891abc123ac"
24
}
Copied!
1
{
2
    "status": "SUCCESS",
3
    "data": {
4
              "code": "S20",
5
              "payments": {
6
                            "paymentReference": "UYTRE234566677RDFGFDDSS",
7
                            "linkingReference": "F320660611587911267617"
8
                           },
9
              "message": "Transaction is pending"
10
             }
11
}
Copied!
Field
Description
Type
​
publicKey
This is available after sign-up 
dash board -> settings -> api keys.
String
Required
amount
Amount to be paid
String
Required
fee
Charge on transaction,  customer or merchant to bear
whom to bear this can be set on the dashboard by merchant
String
Optional
fullName
Customer name
String
Optional
mobileNumber
Customer phone number
String
Optional
currency
Currency to perform transaction
String
Required
country
Country the customer is performing the transaction
String
Required
paymentReference
Unique payment identifier, to be supplied by the merchant
String
Required
email
Customer's Email
String
Required
productId
Unique identification number for each product, To be supplied by the Merchant
String
Optional
productDescription
Narration of Transaction
String 
Optional
clientAppCode
Extra data
String
Optional
redirectUrl
Url to redirect to
String
Required
bvn
Customers' bank verification number. 
String
Optional
paymentType
Medium by which the payment transaction is made {ACCOUNT}
String
Required
deviceType
Customer device
String
Optional
sourceIP
Customer's IP Address
String
Optional
accountName
Customer's account name
String
Required
accountNumber
Customer's account number to debit
String
Required
bankCode
Bank's Unique identifier
String
Required
dateOfBirth
Customer's registered date of birth for debit card
String
Optional
retry
This is passed as true to retry a failed transaction.
Boolean
Required
invoiceNumber
​
String
Optional
message
Response message from SeerBit
​
​
code
Response code from SeerBit
​
​
linkingReference
SeerBit transaction unique identifier
​
​
Validate Transaction
This option is used to complete an account transaction, when OTP is required.
Authentication
Request Body
Response Body
1
curl -X POST
2
https://seerbitapi.com/api/v2/payments/validate
3
-H 'Content-Type: application/json' 
4
-H 'Authorization: Bearer {token}
Copied!
1
{
2
	"linkingReference":"F320660611587911267617",
3
	"otp":"68871001"
4
}
Copied!
1
{
2
    "status": "SUCCESS",
3
    "data": {
4
              "code": "00",
5
              "payments": {
6
                            "reference": "UYTRE234566677RDFGFDDSS",
7
                            "linkingreference": "F320660611587911267617"
8
                          },
9
               "message": "Successful"
10
             }
11
}
Copied!
How do you want to integrate?
Simple Checkout
Standard Checkout
Libraries
E-commerce Checkout
​
Transfer
List Banks
Last modified 1yr ago
Copy link
Contents