Skip to main content
The Resolve API allows you to verify bank and mobile money accounts before making transfers. This helps prevent failed transactions and ensures money goes to the right recipient.

Overview

Before sending money, you should resolve the recipient’s account to:
  • Verify the account exists
  • Get the account holder’s name for confirmation
  • Prevent transfers to invalid accounts

Endpoints

EndpointMethodDescription
/bila/resolve/bank-accountPOSTVerify bank account and get holder name
/bila/resolve/mobile-moneyPOSTVerify mobile money account and get holder name

Resolve Bank Account

Request Body

{
  "accountNumber": "1234567890",
  "bankId": "bank-001",
  "country": "zm"
}

Response

{
  "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

{
  "phone": "0977123456",
  "operator": "airtel",
  "country": "zm"
}

Response

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

Mobile Money Operators

OperatorCode
Airtel Moneyairtel
MTN Mobile Moneymtn
Zamtel Kwachazamtel

Best Practices

Resolve accounts before creating transfers to prevent failures and ensure the recipient name matches expectations.
Display the resolved account name to your users for confirmation before proceeding with the transfer.

API Reference

View the interactive API reference for Resolve endpoints