> For the complete documentation index, see [llms.txt](https://docs.vpay.africa/vpay-api-specification-basic-gude/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vpay.africa/vpay-api-specification-basic-gude/glossary.md).

# Glossary

**Conventions**

* All responses are in JSON format
* All request parameters are mandatory unless explicitly marked as <mark style="color:red;">optional</mark>

**Status Codes**

Below (marked in red) are the list of codes considered as failed transfers.

* <mark style="color:green;">00</mark> - Successful Transfer
* <mark style="color:red;">XX</mark> - Failed/Pending Transfers

<table><thead><tr><th width="143.5">Status Code</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:green;">00</mark></td><td>Approved or completed successfully</td></tr><tr><td><mark style="color:red;">01</mark></td><td>Invalid Sender</td></tr><tr><td><mark style="color:red;">05</mark></td><td>Do not honour</td></tr><tr><td><mark style="color:red;">06</mark></td><td>Dormant Account</td></tr><tr><td><mark style="color:red;">07</mark></td><td>Invalid Account</td></tr><tr><td><mark style="color:red;">08</mark></td><td>Account Name Mismatch</td></tr><tr><td><mark style="color:orange;">09</mark></td><td>Invalid transaction (Pending transaction)</td></tr><tr><td><mark style="color:red;">10</mark></td><td>Invalid Amount</td></tr><tr><td><mark style="color:red;">12</mark></td><td>Invalid transaction</td></tr><tr><td><mark style="color:red;">14</mark></td><td>Invalid Batch Number</td></tr><tr><td><mark style="color:red;">15</mark></td><td>Invalid Session or Record ID</td></tr><tr><td><mark style="color:red;">16</mark></td><td>Unknown Bank Code</td></tr><tr><td><mark style="color:red;">17</mark></td><td>Invalid Channel</td></tr><tr><td><mark style="color:red;">18</mark></td><td>Wrong Method Call</td></tr><tr><td><mark style="color:red;">21</mark></td><td>No action taken</td></tr><tr><td><mark style="color:red;">25</mark></td><td>Unable to locate record</td></tr><tr><td><mark style="color:red;">26</mark></td><td>Duplicate record</td></tr><tr><td><mark style="color:red;">30</mark></td><td>Format error</td></tr><tr><td><mark style="color:red;">34</mark></td><td>Suspected Fraud</td></tr><tr><td><mark style="color:red;">35</mark></td><td>Contact sending bank</td></tr><tr><td><mark style="color:red;">51</mark></td><td>No sufficient funds</td></tr><tr><td><mark style="color:red;">57</mark></td><td>Transaction not permitted to sender</td></tr><tr><td><mark style="color:red;">58</mark></td><td>Transaction not permitted on channel</td></tr><tr><td><mark style="color:red;">61</mark></td><td>Transfer limit Exceeded</td></tr><tr><td><mark style="color:red;">63</mark></td><td>Security Violation</td></tr><tr><td><mark style="color:red;">65</mark></td><td>Exceeds withdrawal frequency</td></tr><tr><td><mark style="color:red;">68</mark></td><td>Response received too late</td></tr><tr><td><mark style="color:red;">69</mark></td><td>Unsuccessful Account/Amount block</td></tr><tr><td><mark style="color:red;">70</mark></td><td>Unsuccessful Account/Amount unblock</td></tr><tr><td><mark style="color:red;">71</mark></td><td>Empty Mandate Reference Number</td></tr><tr><td><mark style="color:red;">91</mark></td><td>Beneficiary Bank not available</td></tr><tr><td><mark style="color:red;">92</mark></td><td>Routing error</td></tr><tr><td><mark style="color:red;">94</mark></td><td>Duplicate transaction</td></tr><tr><td><mark style="color:red;">96</mark></td><td>System malfunction</td></tr><tr><td><mark style="color:red;">97</mark></td><td>Timeout waiting for response from destination</td></tr><tr><td><mark style="color:red;">98</mark></td><td>Transaction Exists</td></tr><tr><td><mark style="color:red;">99</mark></td><td>Transaction Failed</td></tr><tr><td><mark style="color:red;">102</mark></td><td>Invalid BVN or Could Not Reach BVN Service</td></tr><tr><td><mark style="color:red;">103</mark></td><td>Date of Birth Mismatch</td></tr><tr><td><mark style="color:red;">104</mark></td><td>Account Not Found</td></tr><tr><td><mark style="color:red;">105</mark></td><td>Bank Not Found</td></tr><tr><td><mark style="color:red;">107</mark></td><td>Unable to Retrieve Account Details</td></tr><tr><td><mark style="color:red;">108</mark></td><td>Transaction Not Found</td></tr><tr><td><mark style="color:red;">109</mark></td><td>Signature Mismatch</td></tr><tr><td><mark style="color:red;">119</mark></td><td>Unauthorised Client Creation</td></tr><tr><td><mark style="color:red;">199</mark></td><td>Mandatory Property Missing</td></tr><tr><td><mark style="color:red;">500</mark></td><td>Internal Server Error</td></tr><tr><td><mark style="color:red;">929</mark></td><td>Failed Request</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.vpay.africa/vpay-api-specification-basic-gude/glossary.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.