Response Codes
This section contains the response codes you will likely get from the VTpass API.
The “code” parameter would usually contain the following response.
| Response Code | Meaning | Note |
| 000 | TRANSACTION PROCESSED | Transaction is processed. Please check [content][transactions][status] for the status of the transaction. It would contain the actual state like initiated, pending, delivered, reversed, resolved. See the next table for more information. |
| 099 | TRANSACTION IS PROCESSING | Transaction is currently precessing. In such situation, you should requery using your requestID to ascertain the current status of the transaction. |
| 016 | TRANSACTION FAILED | TRANSACTION FAILED |
| 001 | TRANSACTION QUERY | The current status of a given transaction carried out on the platform |
| 010 | VARIATION CODE DOES NOT EXIST | You are using an invalid variation code. Please check the list of available variation codes here. |
| 011 | INVALID ARGUMENTS | You are not passing at least one of the arguments expected in your request. |
| 012 | PRODUCT DOES NOT EXIST | PRODUCT DOES NOT EXIST |
| 013 | BELOW MINIMUM AMOUNT ALLOWED | You are attempting to pay an amount lower than the minimum allowed for that product/service. |
| 014 | REQUEST ID ALREADY EXIST | You have used the RequestID for a previous transaction. |
| 015 | INVALID REQUEST ID | This is returned for a requery operation. This RequestID was not used on our platform. |
| 017 | ABOVE MAXIMUM AMOUNT ALLOWED | You are attempting to pay an amount higher than the maximum allowed for that product/service. |
| 018 | LOW WALLET BALANCE | You do not have adequate funds in your wallet to cover the cost of the transaction. |
| 019 | LIKELY DUPLICATE TRANSACTION | You attempted to buy thesame service multiple times for the same biller_code within 30 seconds. |
| 020 | BILLER CONFIRMED | BILLER CONFIRMED |
| 021 | ACCOUNT LOCKED | Your account is locked |
| 022 | ACCOUNT SUSPENDED | Your account is suspended |
| 023 | API ACCESS NOT ENABLE FOR USER | Your account does not have API access enabled. Please contact us to request for activation |
| 024 | ACCOUNT INACTIVE | Your account is inactive. |
| 025 | RECIPIENT BANK INVALID | Your bank code for bank transfer is invalid. |
| 026 | RECIPIENT ACCOUNT COULD NOT BE VERIFIED | Your bank account number could not be verified. |
| 027 | IP NOT WHITELISTED, CONTACT SUPPORT | You need to contact support with your server IP for whitelisting |
| 030 | BILLER NOT REACHABLE AT THIS POINT | The biller for the product or service is unreachable. |
| 031 | BELOW MINIMUM QUANTITY ALLOWED | You are under-requesting for a service that has a limit on the quantity to be purchased per time. |
| 032 | ABOVE MINIMUM QUANTITY ALLOWED | You are over-requesting for a service that has a limit on the quantity to be purchased per time. |
| 034 | SERVICE SUSPENDED | The service being requested for has been suspended for the time being. |
| 035 | SERVICE INACTIVE | You are requesting for a service that has been turned off at the moment. |
| 040 | TRANSACTION REVERSAL | Transaction reversal to wallet |
| 083 | SYSTEM ERROR | Oops!!! System error. Please contact tech support |
Transaction Response Format
This section contains the response format for [content][status] when the transactions is processed and the code “000” is returned.
It determines the actual state of a processed transaction
When the “code” parameter returns “000”, the following “status” are applicable.
| Response Code | Meaning | Note |
| initiated | Transaction has been initiated | Transaction is initiated. |
| pending | Transaction is pending. | Transaction is pending. This may happen when service provider has not concluded the transaction. This status will be updated. Please requery to get a final status. |
| delivered | Transaction Successful | Transaction is successful and service is confirmed as delivered. |
| reversed | Transaction Reversed | Payment reversed to your wallet |
| resolved | Transaction has been Resolved | Please contact us for more information |