Payments API Errors

This section provides an overview of potential error responses in Orbital Payments API.
Find detailed insights into specific issues within error responses, find exactly what went wrong.

404 Not Found: means that the server couldn't find the requested resource. This happens if the payment or endpoint you're trying to reach doesn't exist or it's returned when the URL is incorrect.

422 Unprocessable Entity: this is returned when the server understood the request, but the data sent is invalid or incomplete. This usually happens if the required fields are missing or the data format is incorrect.

Errors adhere to the sample JSON format below:

{
    "status": "fail",
    "data": {
        "type": "vendor_error",
        "title": "Trade was not executed. Try again.",
        "status": 400
    },
    "message": null
}

Below is the definition of the error fields above

status : Represents the status of the executed request
message: Represents the definition of the error in the response
data: Represents an object that describes the error during the transaction execution
type: Represent the type of error
title: Represents a detailed description of the error
status: A numeric value that represents the status code for type of error

Some message definition in error responses with status code 400.

titleaction required
Your request parameters didn't validate.Check and verify all parameters in request are valid.
Example:

- Check the wallet address is supported by the transaction.
- Check target currency and other relevant fields
not_supported currency_errorChange “currency” field to support Expected 'ETH'
not_supported_target_currency_error
invalid targetCurrency
This target currency is not supported. Change it to Expected 'BTC'
balance_too_lowInsufficient balance for the transaction. Please fund the MID.
duplicate_external_idA duplicate external ID was found. Change it.
missing_cashier_amount_in_requestThe cashier amount is missing from this request.
Either cashier amount and cashier currency or target amount and target currency are required.
payment_not_found_errorThe specified payment could not be found.
identical_target_and_cashier_currencyTarget and cashier currencies are identical.
Trade was not executed. Try againSource Amount does not meet the minimum threshold for transaction

For assistance, contact Orbital support.