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

# Resolve Account

> Verify bank and mobile money accounts before transfers

Verify bank and mobile money accounts before making transfers. Returns the account holder's name for confirmation.

## Endpoints

| Endpoint                     | Method | Description                                     |
| ---------------------------- | ------ | ----------------------------------------------- |
| `/bila/resolve/bank-account` | POST   | Verify bank account and get holder name         |
| `/bila/resolve/mobile-money` | POST   | Verify mobile money account and get holder name |

## Resolve Bank Account

### Request Body

```json theme={null}
{
  "accountNumber": "1234567890",
  "bankId": "bank-001",
  "country": "zm"
}
```

### Response

```json theme={null}
{
  "status": true,
  "message": "Bank account resolved successfully",
  "data": {
    "accountNumber": "1234567890",
    "accountName": "JOHN DOE",
    "bankId": "bank-001",
    "bankName": "Zambia National Commercial Bank"
  }
}
```

## Resolve Mobile Money

### Request Body

```json theme={null}
{
  "phone": "0977123456",
  "operator": "airtel",
  "country": "zm"
}
```

### Response

```json theme={null}
{
  "status": true,
  "message": "Mobile money account resolved successfully",
  "data": {
    "phone": "0977123456",
    "accountName": "JOHN DOE",
    "operator": "airtel"
  }
}
```

## Mobile Money Operators

| Operator         | Code     |
| ---------------- | -------- |
| Airtel Money     | `airtel` |
| MTN Mobile Money | `mtn`    |
| Zamtel Kwacha    | `zamtel` |

## Best Practices

<AccordionGroup>
  <Accordion title="Always resolve before transfer">
    Resolve accounts before creating transfers to prevent failures and ensure the recipient name matches expectations.
  </Accordion>

  <Accordion title="Show confirmation to users">
    Display the resolved account name to your users for confirmation before proceeding with the transfer.
  </Accordion>
</AccordionGroup>

<a href="/docs/api-reference" style={{ textDecoration: 'none', borderBottom: 'none', display: 'block' }}>
  <div
    style={{
  borderRadius: '16px',
  padding: '32px',
  height: '120px',
  display: 'flex',
  flexDirection: 'column',
  justifyContent: 'flex-end',
  border: '0.5px solid #f16101',
  cursor: 'pointer',
  transition: 'all 0.15s ease-in-out',
  boxShadow: '0 4px 14px 0 rgba(241, 97, 1, 0.1)',
}}
    onMouseEnter={e => {
  e.currentTarget.style.background = 'rgba(241, 97, 1, 0.05)';
  e.currentTarget.style.boxShadow = '0 6px 20px 0 rgba(241, 97, 1, 0.2)';
  e.currentTarget.style.transform = 'translateY(-2px)';
}}
    onMouseLeave={e => {
  e.currentTarget.style.background = 'transparent';
  e.currentTarget.style.boxShadow = '0 4px 14px 0 rgba(241, 97, 1, 0.1)';
  e.currentTarget.style.transform = 'none';
}}
  >
    <div style={{ fontSize: '24px', marginBottom: '8px' }}>⟡</div>
    <div style={{ fontWeight: '500', fontSize: '16px' }}>API Reference</div>
    <div style={{ opacity: 0.6, fontSize: '13px', marginTop: '4px' }}>Explore the complete API reference</div>
  </div>
</a>