Use this endpoint to simulate a successful virtual account credit in test mode. The endpoint is rejected in live mode.

-H "x-api-key: your_secret_key"

POST {{host}}/v1/wallets/credit

Request Body

Field	Data Type	Required	Description
accountNumber	string	Yes	Virtual account number to credit.
amount	string	Yes	Amount to simulate. Must be a positive number.

{
  "accountNumber": "1234567890",
  "amount": "5000"
}

{
  "status": true,
  "message": "Success",
  "code": 201,
  "data": {
    "status": "SUCCESS",
    "message": "Wallet credit simulated successfully",
    "reference": "TEST-VFD-abc123",
    "sessionId": "TEST1778623597453abc123",
    "accountNumber": "1234567890",
    "amount": 5000,
    "mode": "test",
    "provider": "VFD"
  }
}