> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rapidtopup.com.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify Customer

> Resolve a smartcard or meter number to a customer name. Mandatory before Cable TV or Electricity purchases.

## Request

**Authorization** `string` *required*

Bearer token: `Bearer <api-key>`

**type** `string` *required*

Service type. Either `cable_tv` or `electricity`

**service\_id** `string` *required*

Provider ID. E.g. `dstv`, `gotv`, `startimes`, `ikeja-electric`, `eko-electric`

**account\_number** `string` *required*

The smartcard number (Cable TV) or meter number (Electricity)

**variation\_code** `string`

Electricity only. `prepaid` or `postpaid`. Defaults to `prepaid` if not provided.

***

## Examples

```bash cURL — Electricity theme={null}
curl --request GET \
  --url 'https://api.rapidtopup.com.ng/api/v2/b2b/services/verify?type=electricity&service_id=ikeja-electric&account_number=04012345678&variation_code=prepaid' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api-key>'
```

```bash cURL — Cable TV theme={null}
curl --request GET \
  --url 'https://api.rapidtopup.com.ng/api/v2/b2b/services/verify?type=cable_tv&service_id=dstv&account_number=1234567890' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <api-key>'
```

```javascript JavaScript (Fetch) theme={null}
// Electricity example
const params = new URLSearchParams({
  type: 'electricity',
  service_id: 'ikeja-electric',
  account_number: '04012345678',
  variation_code: 'prepaid',
});

const response = await fetch(
  `https://api.rapidtopup.com.ng/api/v2/b2b/services/verify?${params}`,
  {
    method: 'GET',
    headers: {
      'Accept': 'application/json',
      'Authorization': 'Bearer <api-key>',
    },
  }
);

const data = await response.json();
// { status: 'success', data: { customer_name: 'JOHN DOE', account_number: '04012345678' } }
```

```php PHP (Guzzle) theme={null}
<?php

use GuzzleHttp\Client;

$client = new Client();

// Electricity example
$response = $client->request('GET', 'https://api.rapidtopup.com.ng/api/v2/b2b/services/verify', [
    'headers' => [
        'Accept'        => 'application/json',
        'Authorization' => 'Bearer <api-key>',
    ],
    'query' => [
        'type'           => 'electricity',
        'service_id'     => 'ikeja-electric',
        'account_number' => '04012345678',
        'variation_code' => 'prepaid',
    ],
]);

$data = json_decode($response->getBody(), true);
echo $data['data']['customer_name']; // "JOHN DOE"
```

***

## Response

**status** `string`

`success` or `error`

**data** `object`

**data fields**

**customer\_name** `string`

The name registered to the account. Display this prominently to your user for confirmation.

**account\_number** `string`

Echo of the account number you submitted.

**✅ Success `200`:**

```json theme={null}
{
  "status": "success",
  "data": {
    "customer_name": "JOHN DOE",
    "account_number": "04012345678"
  }
}
```

**❌ Invalid Account `404`:**

```json theme={null}
{
  "status": "error",
  "message": "Invalid meter number or provider."
}
```

***

## Integration Flow

**1. User enters account number**

Collect the meter or smartcard number in your UI.

**2. Call GET /services/verify**

Pass the account number, service ID, and type to our verification endpoint.

**3. Show customer\_name prominently**

Display the name clearly. E.g. *"Recharging account for: JOHN DOE"*

**4. User confirms**

Only proceed if the user confirms the name matches their account.

**5. Call POST /purchase**

Proceed with the purchase using the same `account_number` and `service_id`.

> [!WARNING]
>
> This endpoint is **mandatory** before any Cable TV or Electricity purchase. Funds sent to the wrong account cannot be reversed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.