Error Codes

Response Status

The result.status field indicates the overall outcome:

Status	Meaning
`success`	Request processed successfully
`warning`	Request failed — check error codes

Error Codes

The result.codeError and result.codeErrorExt fields provide details:

`codeError` Values

Code	Description
`none`	No error
`validationError`	Request validation failed
`internalError`	Internal server error

`codeErrorExt` Values

Code	Description	Action
`none`	No error	—
`internalError`	Undefined internal error	Retry or contact support
`invalidRequestParameters`	Missing or invalid required fields	Check request body
`duplicateIdentifier`	`idTransactionMerchant` already used	Use a unique identifier
`noSuitableTariffForRequest`	No tariff configured for this amount/method	Contact your manager
`noPaymentDetailsAvailable`	No payment details available from providers	Retry later or try different method
`notEnoughMoneyOnBalance`	Insufficient balance for payout	Top up your balance
`fraud`	Fraud detected by antifraud system	Transaction blocked

Error Response Example

{
  "result": {
    "status": "warning",
    "x-request-id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "codeError": "none",
    "codeErrorExt": "noPaymentDetailsAvailable",
    "message": "Not found available payment details"
  },
  "data": null,
  "totalNumberRecords": 0
}

Common Issues

`noPaymentDetailsAvailable`

All providers are currently busy or unavailable for the requested amount and payment method. Try again in a few seconds or use a different payment method.

`duplicateIdentifier`

You've already created an operation with this idTransactionMerchant. Each operation must have a unique merchant transaction ID. Use the Operations API to check the existing operation's status.

`notEnoughMoneyOnBalance`

Your merchant balance is insufficient for the requested payout amount. Top up your balance first.

`noSuitableTariffForRequest`

Your merchant account doesn't have a tariff configured for the requested payment method or amount range. Contact your PixelWave manager.

Error Codes

On this page