Account Name Validation

Name Validation

This is a compulsory operation that must be carried out before any purchase is done on any valid multichoice smartcard account. See the Account finder service for more details.

POST https://payments.baxipay.com.ng/api/baxipay/services/namefinder/query

MULTICHOICE NAME VALIDATION

This method returns some very vital information, that we need to pay attention to.

1. The full name of the valid owner of the account.
2. It also returns the current bouquet plan of the user if available.
3. The due date of the current subscription
4. The outstanding balance that the customer is expected to pay in case of a renewal of a subscription plan.

For DSTV, the service type is "dstv".
For GOTV, the service type is "gotv".

SEE THE REQUEST / RESPONSE TAB BELOW

Parameters

Header

x-api-key string See Baxi Authentication page

Accept string application/json

Content-Type string application/json

Body

account_number string This is a valid smart card number. i.e. 1031420508.

service_type string "dstv" or "gotv"

Responses

• 200 Under the "user" Object,

                                                           1. The "name" property contains the name of the valid
                                                            smartcard account holder.
                                                      
                                                           2. The "outstandingBalance" property contains the amount
                                                           the user is expected to pay and this is mandatory to be displayed
                                                           during subscription renewal. 
  
                                                          3. The "dueDate" property directly under the user contains the date
                                                          the current subscription will expire. This is mandatory to be displayed
                                                          during subscription renewal.
  
                                                          4. The "currentBouquet" property which is the last property under the 
                                                          user contains a string showing the current subscription of the user.
                                                          This is mandatory and expected to be displayed during subscription
                                                          renewal.
  

{
    "status": "success",
    "message": "Successful",
    "code": 200,
    "data": {
        "user": {
            "name": "IGINLA OMOTAYO",
            "address": null,
            "outstandingBalance": 2381,
            "dueDate": "2021-11-02T00:00:00+01:00",
            "district": null,
            "accountNumber": null,
            "minimumAmount": null,
            "rawOutput": {
                "accountStatus": "OPEN",
                "firstName": "IGINLA",
                "lastName": "OMOTAYO",
                "customerType": "SUD",
                "invoicePeriod": 1,
                "dueDate": "2021-11-01T00:00:00+01:00",
                "customerNumber": 252177429
            },
            "errorMessage": null,
            "currentBouquetRaw": {
                "amount": 2565,
                "items": [
                    {
                        "code": "FRUBE36",
                        "price": 0,
                        "name": "DStv FreeView Public Broadcaster E36",
                        "description": "DStv FreeView Public Broadcaster E36"
                    },
                    {
                        "code": "NNJ1E36",
                        "price": 2565,
                        "name": "DStv Yanga Bouquet E36",
                        "description": "DStv Yanga Bouquet E36"
                    }
                ]
            },
            "currentBouquet": "DStv FreeView Public Broadcaster E36 + DStv Yanga Bouquet E36"
        }
    }
}