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 https://payments.baxipay.com.ng/api/baxipay/services/namefinder/query

Parameters

Path

Authorization string This is described in the authentication section.

Body

account_number string This is the account number of the user you are trying to verify.

service_type string This is the service type code of the service you are trying to verify.

Responses

{
    "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
SPECTRANET	spectranet
SMILE COMM	smile
IKEJA ELECTRIC PREPAID	eko_electric_prepaid
IKEJA ELECTRIC POSTPAID	eko_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	kedco_electric_prepaid
KANO ELECTRIC POSTPAID	kedco_electric_postpaid
ABUJA ELECTRIC PREPAID	kaduna_electric_prepaid
ABUJA ELECTRIC POSTPAID	kaduna_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