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

# Validate Recharge Account

> Validate a customer's recharge account before placing a biller reseller order

Validate a customer's recharge account before placing an order. This confirms that the account exists with the provider and prevents failed orders.

## Usage

```bash theme={null}
curl -X POST https://api.payvessel.com/vaas/api/v1/biller-reseller/validate-account \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recharge_account": "12345678",
    "biller_id": "BET9JA_BILLER_ID"
  }'
```

## Request body

| Field              | Type   | Required | Description                                                                                      |
| ------------------ | ------ | -------- | ------------------------------------------------------------------------------------------------ |
| `recharge_account` | string | Yes      | The customer's account (phone number or betting ID). Max 15 characters.                          |
| `biller_id`        | string | Yes      | The biller to validate against. Alphanumeric, hyphens, and underscores only (max 64 characters). |
| `item_id`          | string | No       | Optional item ID for context. Alphanumeric, hyphens, and underscores only (max 64 characters).   |

## Response

The response `data` object contains:

| Field    | Type           | Description                                        |
| -------- | -------------- | -------------------------------------------------- |
| `biller` | string or null | The resolved biller/account name from the provider |

## Sandbox testing

In sandbox mode, only the following recharge accounts are valid:

| Recharge Account | Account Name    |
| ---------------- | --------------- |
| `1234567890`     | John Doe        |
| `0987654321`     | Jane Smith      |
| `1111111111`     | Test User One   |
| `2222222222`     | Test User Two   |
| `3333333333`     | Test User Three |

Any other account number will return a validation error.

<Card title="API Reference" icon="code" href="/api-reference/biller-reseller/validate-account">
  Full request/response details and Try it
</Card>