Skip to main content

Dictionaries

Payment states

StateFinalDescription
initnoRequest to API will initiate payments.
pendingnoUser redirected to the Defexa Payments Checkout facility during payment processing period.
approvedyesSuccessfully completed payment.
declinedyesUnsuccessful payment.

Payment API statuses

API statusDescription
0created
1accepted
2declined
3hold
4refunded
5refunding

Support currencies

NameNetwork
DOGEDoge
LTCLitecoin
DASHDash
NEMNem
AVAXAvalanche
BTC_CASHBitcoin Cash
BTCBitcoin
ETHEthereum
ALGOAlgorand
TONTon
TRXTron
MATIC_PLGPolygon
SOLSolana
EOSEOS
BNBBSC
USDT_ERC20Ethereum
USDT_BSCBSC
USDC_ERC20Ethereum
USDT_TONTon
USDT_POLPolygon
USDC_POLPolygon
USDT_TRC20Tron

The name field from this list is used for all API requests where the parameter currency is present.

Errors

CodeDescription
merchant_not_foundThe current private key cannot identify the user.
order_number_already_existsRepeating an order of already identified order number.****
amount_less_than_balancePayout cannot be completed due to insufficient funds.
[parameter] is missingAbsent or incorrect parameter value.
amount_less_than_minimumMinimum payout amount has not been requested.
session_token is blankAbsent session_token value.
session_not_validIncorrect session_token.
otp_incorrectAbsent or incorrect OTP value.
Access is denied. IP [ip] is not in whitelistIP is not in whitelist.
private_key errorIncorrect private key value.
payment_not_foundPayment not found for AML refund.
payment_completedThe payment is already in final status and no refund is possible.
aml_refund_startedThe payment has pending refund.
transaction_cannot_be_returnedPayment is not refundable.
type_is_invalidIncorrect type value.
settings_api_errorSettings not found for the transaction.
currency_not_supportedCurrency is not supported for the transaction.
order_number_is_blankOrder number is blank.
The balance is less than the withdrawal amountThe balance is less than the withdrawal amount
from_wallet_not_foundPayment wallet not found.
payment_not_foundInvalid token or payment not found
missing_required_paramsMissing required parameters

Error response examples

If any method failed, the JSON response with status code 403/422 returned that specified the problem.

Return status 403 and JSON:

{
"success": false,
"result": 1,
"status": 403,
"errors": {
"list": [
{ "code": "merchant_not_found" }
]
}
}
{
"success": false,
"result": 1,
"status": 403,
"errors": [
{ "code": "amount_less_than_minimum" }
]
}
{
"success": false,
"result": 1,
"status": 403,
"errors": [
{ "code": "amount_less_than_balance" }
]
}