Baxi
Baxi
Capricorn Digital Limited
Baxipay
BAXI B2B API Documentation
Available Services
Getting Started
Test Parameters
Authentication
Baxi Authentication
HMAC Auth Sample Codes
Request Playground
Integration Flow
Requests
Response
User Account
Get Balance
Billers
Fetch Biller Categories
Fetch All Billers
Fetch Billers By Category
Airtime Services
Airtime recharge providers
Purchase Airtime
Data Bundle Services
Data Bundle Providers
Retrieve Provider Bundles
Purchase Data Bundle
Cable TV Services
Cable TV Providers
Retrieve Provider Bouquets
Retrieve Bouquet Addons
Purchase Subscription
e-pin Services
E-pin Service Providers
Retrieve Pin Bundles
Purchase Pin
Electricity Services
Electricity Service Providers
Verify Meter Account
Purchase Electricity
Account Name Verifier
Account Finder Service
Contact
Contact Us
Single Request Point
Single Request Point
Powered by GitBook

Account Finder Service

There are some services that requires that the user account details is correct and verified before proceeding with the transaction. This service is used to verify the account details to ensure payment is made into the right account.

post
Account Finder Service

https://test.platform.baxibox.com/services/namefinder/query
This method simply uses the account number to retrieve the account details of the user with the service provider for verification.
Request
Response
Request
Path Parameters
Authorization
required
string
This is described in the authentication section
Body Parameters
account_number
required
string
This is the account number of the user you are trying to verify.
service_type
required
string
This is the service type code of the service you are trying to verify.
Response
200: OK
{
    "status": "success",
    "message": "Successful",
    "code": 200,
    "data": {
        "user": {
            "name": "NP NGEMA",
            "address": "6 ABIODUN ODESEYE Shomolu BU",
            "outstandingBalance": 31829,
            "district": null,
            "accountNumber": "04042404139",
            "minimumAmount": 250,
            "rawOutput": {
                "address": "6 ABIODUN ODESEYE Shomolu BU",
                "outstandingAmount": 31829,
                "name": "NP NGEMA",
                "minimumAmount": 250,
                "customerAccountType": "PRIME",
                "accountNumber": "04042404139",
                "customerDtNumber": "007903312"
            }
        }
    }
}

​

Below is a list of providers that you can use along side the name finder service

Provider

Service Type Code

DSTV

dstv

GOTV

gotv

STARTIMES

startimes

SMILE COMM

smile

IKEJA ELECTRIC PREPAID

ikeja_electric_prepaid

IKEJA ELECTRIC POSTPAID

ikeja_electric_postpaid

IBADAN ELECTRIC PREPAID

ibadan_electric_prepaid

IBADAN ELECTRIC POSTPAID

ibadan_electric_postpaid

EKO ELECTRIC PREPAID

eko_electric_prepaid

EKO ELECTRIC POSTPAID

eko_electric_postpaid

KANO ELECTRIC PREPAID

kano_electric_prepaid

KANO ELECTRIC POSTPAID

kano_electric_postpaid

ABUJA ELECTRIC PREPAID

abuja_electric_prepaid

ABUJA ELECTRIC POSTPAID

abuja_electric_postpaid

JOS ELECTRIC PREPAID

jos_electric_prepaid

JOS ELECTRIC POSTPAID

jos_electric_postpaid

ENUGU ELECTRIC PREPAID

enugu_electric_prepaid

ENUGU ELECTRIC POSTPAID

enugu_electric_postpaid

KADUNA ELECTRIC PREPAID

kaduna_electric_prepaid

KADUNA ELECTRIC POSTPAID

kaduna_electric_postpaid

PORTHARCOURT ELECTRIC PREPAID

portharcourt_electric_prepaid

PORTHARCOURT ELECTRIC POSTPAID

portharcourt_electric_postpaid

​

Electricity Services - Previous
Purchase Electricity
Next - Contact
Contact Us
Last updated 4 weeks ago