Order status codes
Order status helps with current status of the order, and progress of the transaction
Onramp Status codes
The merchantHistory and webhook updates endpoints provide status updates for transactions initiated through the API. The status code included in the response indicates the current stage of the order. The following status codes and their respective meanings are listed below:
| Status code | Meaning | Description |
|---|---|---|
-4 | amount mismatch | The sent amount does not match the required amount. |
-3 | bank and kyc name mismatch | The names on the bank account and KYC do not match. |
-2 | transaction abandoned | The user has abandoned the transaction. |
-1 | transaction timed out | The transaction has exceeded the allowable time limit. |
0 | transaction created | The transaction has been successfully created. |
1 | referenceId claimed | The Reference ID has been successfully claimed. |
2 | deposit secured | The deposit for the transaction has been secured. |
3, 13 | crypto purchased | The desired cryptocurrency has been purchased. |
4, 15 | withdrawal complete | The withdrawal process is completed. |
5, 16 | webhook sent | The webhook notification has been sent. |
11 | order placement initiated | The process of placing the order has begun. |
12 | purchasing crypto | The cryptocurrency purchase is in progress. |
14 | withdrawal initiated | The withdrawal process has started. |
Note:
If webhooks are not enabled, transactions that complete successfully will be assigned a status code of either 4 or 15.
Offramp status codes
The merchantHistory endpoint in onramp.money's API provides status updates for transactions that are initiated through the platform's offramp service. The status code returned in the response corresponds to the current stage of the transaction. Below are the status codes and their respective meanings:
| Status code | Meaning | Description |
|---|---|---|
-4 | amount mismatch | The sent amount does not match the required amount. |
-2 | Transaction Abandoned | The user has abandoned the transaction. |
-1 | Transaction Timed Out | The transaction has exceeded the allowable time limit. |
0 | order created | The order has been successfully created. |
1 | Order Confirmed | The order has been confirmed and a transaction hash has been generated. |
2,10,11 | deposit found, selling crypto | The transaction hash has been successfully located. |
3 | over limit | The user sent a quantity of cryptocurrency that exceeds their KYC limit, and their funds are withheld pending manual review. |
4,12 | crypto sold | The cryptocurrency has been sold. |
5,13,30,31,32,33,34,35,36 | fiat withdrawal initiated to bank | The process of fiat withdrawal has started. |
6,14,40 | fiat withdrawal processed | The fiat withdrawal process is complete. |
7,15,41 | webhook sent | The webhook notification has been sent. |
17 | Provide Alternate Bank | The user has the option to provide an alternate bank account for the transaction. |
18 | Processing to Alternate Bank | The transaction is being processed to the alternate bank account provided. |
19 | Success | The fiat has been processed and the transaction has been successfully completed. |
Note:
status updates are only available for merchantHistory. Webhook support would be added soon.
Last updated