Partner API

Lorem Ipsum

Login

Upon initial login, you must update your password. To accomplish this, you must provide your registered email address as the body of the request to the "forgot password" endpoint.
Subsequently, this endpoint returns the bearer token alongside the responseCode, responseMessage and status. If an invalid email or password is passed an error message is returned.
POST
https://partners.seerbitapi.com/auth/login
Request Sample
The code snippet below shows an example request for generating a bearer token
cURL
Node
1{
2    "email":"asiwaju@mailinator.com",
3    "password":"Agbado@12345"
4}
1var raw = "{\n    \"email\":\"asiwaju@mailinator.com\",\n    \"password\":\"32BPTBP622\"\n}";
2
3var requestOptions = {
4  method: 'POST',
5  body: raw,
6  redirect: 'follow'
7};
8
9fetch("https://partners.seerbitapi.com/auth/login", requestOptions)
10  .then(response => response.text())
11  .then(result => console.log(result))
12  .catch(error => console.log('error', error));
Response Sample
The code snippet below shows an example request for generating a bearer token
1{
2    "status": "SUCCESS",
3    "message": "You are required to change your password. Kindly use the forgot password endpoint to generate OTP",
4    "responseCode": null
5}

Forgot Password

When you access this endpoint, an email containing the OTP will be sent to you. This OTP will be required for the reset password endpoint.
NB: This endpoint does not require a token or public-key.
POST
https://partners.seerbitapi.com/auth/password
Request Sample
The code snippet below shows an example request for generating a bearer token
cURL
Node
1{
2    "email": "asiwaju@mailinator.com"
3}
4
1var raw = "{\n    \"email\": \"asiwaju@mailinator.com\"\n}\n\n";
2
3var requestOptions = {
4  method: 'POST',
5  body: raw,
6  redirect: 'follow'
7};
8
9fetch("https://partners.seerbitapi.com/auth/password", requestOptions)
10  .then(response => response.text())
11  .then(result => console.log(result))
12  .catch(error => console.log('error', error));
Response Sample
The code snippet below shows an example request for generating a bearer token
1{
2    "status": "SUCCESS",
3    "message": "Kindly check your email to reset your password",
4    "responseCode": "00"
5}

ResetPassword

Your password must be a minimum of 8 characters long and include at least the following:
One UPPERCASE
One special character like "!@#?", etc
POST
https://partners.seerbitapi.com/auth/reset
Request Sample
The code snippet below shows an example request for generating a bearer token
cURL
Node
1{
2    "email": "asiwaju@mailinator.com",
3    "newPassword": "Agbado@12345",
4    "otp": "400849"
5}
1var raw = "{\n    \"email\": \"asiwaju@mailinator.com\",\n    \"newPassword\": \"Agbado@12345\",\n    \"otp\": \"400849\"\n}";
2
3var requestOptions = {
4  method: 'POST',
5  body: raw,
6  redirect: 'follow'
7};
8
9fetch("https://partners.seerbitapi.com/auth/reset", requestOptions)
10  .then(response => response.text())
11  .then(result => console.log(result))
12  .catch(error => console.log('error', error));
Response Sample
The code snippet below shows an example request for generating a bearer token
1{
2    "status": "SUCCESS",
3    "message": "Password Reset Was Successful",
4    "responseCode": null
5}

Invite a Business

Please refrain from modifying the partnerId and countryCode parameters. You may only change the countryCode if your business operates outside of Nigeria; otherwise, please leave them unchanged.
All fields in this section are mandatory.
POST
https://partners.seerbitapi.com/api/v1/business/invite
Request Sample
The code snippet below shows an example request for generating a bearer token
cURL
Node
1{
2  "name":"Taofeek Shittu",
3  "businessName":"Semicolon Ventures",
4  "email":"anyhow@mailinator.com",
5  "countryCode":"NG",
6  "partnerId":"1"
7}
1var myHeaders = new Headers();
2myHeaders.append("Public-Key", "SBPUBK_PHQQONHKZMXINUGOPUNEX7KQJVVOHO1K");
3
4var raw = "{\n  \"name\":\"Taofeek Shittu\",\n  \"businessName\":\"Semicolon Ventures\",\n  \"email\":\"anyhow@mailinator.com\",\n  \"countryCode\":\"NG\",\n  \"partnerId\":\"1\"\n}";
5
6var requestOptions = {
7  method: 'POST',
8  headers: myHeaders,
9  body: raw,
10  redirect: 'follow'
11};
12
13fetch("https://partners.seerbitapi.com/api/v1/business/invite", requestOptions)
14  .then(response => response.text())
15  .then(result => console.log(result))
16  .catch(error => console.log('error', error));
Response Sample
The code snippet below shows an example request for generating a bearer token
1{
2    "status": "SUCCESS",
3    "message": "Bola has successfully invited a business",
4    "responseCode": "00"
5}

Get Businesses

Pass in your provided sub_partner_id
NB. This endpoint requires a token.
GET
https://partners.seerbitapi.com/api/v1/business/SBT0050/invite
Response Sample
The code snippet below shows an example request for generating a bearer token
1{
2    "status": "SUCCESS",
3    "message": "Businesses have been fetched successfully",
4    "responseCode": "00",
5    "data": [
6        {
7            "businessName": "Semicolon Ventures",
8            "businessEmail": "anyhow@mailinator.com",
9            "businessId": "00019750"
10        }
11    ]
12}

Set Commission

This endpoint allows you set fees for your invited businesses
POST
https://partners.seerbitapi.com/api/v1/business/commission
Request Sample
The code snippet below shows an example request for generating a bearer token
cURL
Node
1{
2    "cappedAmount":"0.00",
3    "mccPercentage":0.60,
4    "businessId": "00019750"
5}
1var myHeaders = new Headers();
2myHeaders.append("Public-Key", "");
3
4var raw = "{\n    \"cappedAmount\":\"3000\",\n    \"mccPercentage\":0.80,\n    \"businessId\": \"0000302\"\n}";
5
6var requestOptions = {
7  method: 'POST',
8  headers: myHeaders,
9  body: raw,
10  redirect: 'follow'
11};
12
13fetch("https://partners.seerbitapi.com/api/v1/business/commission", requestOptions)
14  .then(response => response.text())
15  .then(result => console.log(result))
16  .catch(error => console.log('error', error));
Response Sample
The code snippet below shows an example request for generating a bearer token
1{
2    "status": "FAILED",
3    "message": "Oops: Access Denied!!! Invalid public key",
4    "responseCode": "99"
5}

Change Password

This endpoint requires a token. You use this endpoint if you feel your password might have been compromised.
POST
https://partners.seerbitapi.com/api/v1/business/password
Request Sample
The code snippet below shows an example request for generating a bearer token
cURL
Node
1{
2    "currentPassword":"Agbado@12345",
3    "newPassword":"Government@123"
4}
1var raw = "{\n    \"currentPassword\":\"Agbado@12345\",\n    \"newPassword\":\"Agbado@12345\"\n}";
2
3var requestOptions = {
4  method: 'POST',
5  body: raw,
6  redirect: 'follow'
7};
8
9fetch("https://partners.seerbitapi.com/api/v1/business/password", requestOptions)
10  .then(response => response.text())
11  .then(result => console.log(result))
12  .catch(error => console.log('error', error));
Response Sample
The code snippet below shows an example request for generating a bearer token
1{
2    "status": "FAILED",
3    "message": "An error occurred while changing your password:Your current and new password cannot be the same",
4    "responseCode": null
5}
Need something else?
If you have any questions or need general help, visit our support page
Signup for developer update
You can unsubscribe at any time. Read our privacy policy.