Reference of Xenith status codes and status message
Pay In
Create Pay In
| Error Code | Description |
|---|---|
"API_VALIDATION_ERROR" 400 No retry | The request failed due to invalid input parameters. Check the error response for details on which fields are invalid and correct them accordingly. Common issues include missing required fields or incorrect data formats. |
"DUPLICATE_TRANSACTION_ERROR" 400 No retry | Idempotency key has been used before. Use a unique idempotency key and try again. |
"MINIMUM_AMOUNT_PAYIN_LIMIT" 400 No retry | The transaction amount is below the minimum allowed limit for pay-ins. Contact our support team to get information about the current minimum amount limits for each payment channel. Adjust your request based on the information provided by support. |
MAXIMUM_AMOUNT_PAYIN_LIMIT 400 No retry | The transaction amount exceeds the maximum allowed limit for pay-ins. Reach out to our support team to inquire about the current maximum amount limits for each payment channel. Modify your request to be within the limits specified by the support team. |
"INVALID_PAYMENT_CHANNEL" 400 No retry | The specified payment channel is not valid or not supported. Ensure you're using a correct and active payment channel code as listed in our documentation. |
"MAXIMUM_DAILY_TRANSACTION_VOLUME_EXCEEDED" 400 No retry | You've reached the maximum allowed transaction volume for the day. This limit is in place for security reasons. Wait until the next day to process more transactions, or contact support if you need to increase your limit. |
"SERVER_ERROR" 500 | An error occurred while connecting to our server. This could be due to temporary server issues. To ensure the transaction wasn't processed: 1. Use the Get Payin List API to check if the disbursement was created. 2. If not found, you can safely retry the request. 3. When retrying, use the X-Idempotency-Key header with the same value to prevent duplicate transactions. |
Get Pay In Detail
| Error Code | Description |
|---|---|
"API_VALIDATION_ERROR" 400 | Invalid input parameters. Check the error response for details on which parameters are incorrect. Review the API documentation for proper parameter format and requirements. |
"DATA_NOT_FOUND" 404 | The requested payin detail does not exist or is not accessible. Verify the payin ID and ensure you have the necessary permissions to access this information. |
"SERVER_ERROR" 500 | An unexpected server error occurred. Wait briefly and retry. If the error persists after multiple attempts, contact support. Retrying is safe for this GET operation. |
Get Pay In List
| Error Code | Description |
|---|---|
"API_VALIDATION_ERROR" 400 | Invalid input parameters. Check the error response for details on which parameters are incorrect. Review the API documentation for proper parameter format and requirements. |
"SERVER_ERROR" 500 | An unexpected server error occurred. Wait briefly and retry. If the error persists after multiple attempts, contact support. Retrying is safe for this GET operation. |
Simulate Pay In
| Error Code | Description |
|---|---|
"API_VALIDATION_ERROR" 400 | Invalid input parameters. Check the error response for details on which parameters are incorrect. Review the API documentation for proper parameter format and requirements. |
"TRANSACTION_STATUS_INVALID" 400 | The provided transaction status is not valid for this operation. Verify the allowed status values in the API documentation. |
"TRANSACTION_CATEGORY_INVALID" 400 | The specified transaction category is invalid. Ensure you're using a supported category as listed in the API documentation. |
"INVALID_TRANSACTION_ID" 400 | The transaction ID provided is not valid or does not exist. Check that you're using the correct transaction ID. |
"SERVER_ERROR" 500 | An unexpected server error occurred. Wait briefly and retry. If the error persists after multiple attempts, contact support. |
Pay Out
Create Pay Out
| Error Code | Description |
|---|---|
"API_VALIDATION_ERROR" 400 No retry | The request failed due to invalid input parameters. Check the error response for details on which fields are invalid and correct them accordingly. Common issues include missing required fields or incorrect data formats. |
"DUPLICATE_TRANSACTION_ERROR" 400 No retry | Idempotency key has been used before. Use a unique idempotency key and try again. |
"INVALID_PAYOUT_CHANNEL" 400 No retry | The specified payout channel is not valid or not supported. Ensure you're using a correct and active payout channel code as listed in our documentation. |
"MINIMUM_AMOUNT_PAYOUT_LIMIT" 400 No retry | The transaction amount is below the minimum allowed limit for payouts. Contact our support team to get information about the current minimum amount limits for each payout channel. Adjust your request based on the information provided by support. |
"MAXIMUM_AMOUNT_PAYOUT_LIMIT" 400 No retry | The transaction amount exceeds the maximum allowed limit for payouts. Reach out to our support team to inquire about the current maximum amount limits for each payout channel. Modify your request to be within the limits specified by the support team. |
"INVALID_ACCOUNT_NAME" 400 No retry | The provided account name is invalid or does not match our records. Verify the account name and ensure it's correctly formatted and matches the account associated with the payout. |
"MAXIMUM_DAILY_TRANSACTION_VOLUME_EXCEEDED" 400 No retry | You've reached the maximum allowed transaction volume for the day. This limit is in place for security reasons. Wait until the next day to process more transactions, or contact support if you need to increase your limit. |
"INSUFFICIENT_BALANCE" 422 No retry | There are insufficient funds to complete the payout transaction. Ensure your account has adequate balance before retrying the payout. |
"SERVER_ERROR" 500 | An error occurred while connecting to our server. This could be due to temporary server issues. To ensure the transaction wasn't processed: 1. Use the Get Payout List API to check if the payout was created. 2. If not found, you can safely retry the request. 3. When retrying, use the X-Idempotency-Key header with the same value to prevent duplicate transactions. |
Get Pay Out Detail
| Error Code | Description |
|---|---|
"API_VALIDATION_ERROR" 400 | Invalid input parameters. Check the error response for details on which parameters are incorrect. Review the API documentation for proper parameter format and requirements. |
"DATA_NOT_FOUND" 404 | The requested payout detail does not exist or is not accessible. Verify the payout ID and ensure you have the necessary permissions to access this information. |
"SERVER_ERROR" 500 | An unexpected server error occurred. Wait briefly and retry. If the error persists after multiple attempts, contact support. Retrying is safe for this GET operation. |
Get Pay Out List
| Error Code | Description |
|---|---|
"API_VALIDATION_ERROR" 400 | Invalid input parameters. Check the error response for details on which parameters are incorrect. Review the API documentation for proper parameter format and requirements. |
"SERVER_ERROR" 500 | An unexpected server error occurred. Wait briefly and retry. If the error persists after multiple attempts, contact support. Retrying is safe for this GET operation. |
Get Balances
| Error Code | Description |
|---|---|
"SERVER_ERROR" 500 | An unexpected server error occurred. Wait briefly and retry. If the error persists after multiple attempts, contact support. |