Order Substatuses

Below are the possible substatuses for orders that have been cancelled or have failed during processing. These codes are useful for error handling and help identify the specific cause that prevented the successful completion of a transaction.

Substatus	Technical Description
EXCEDED_LIMIT	The transaction was blocked because it exceeds the maximum limit allowed according to the current system configuration or the regulatory parameters defined for the user.
INTERNAL_ERROR	An internal error occurred in the Retorna services. This could be related to server failures, unhandled exceptions, or infrastructure issues.
EXTERNAL_PROVIDER_ERROR	The attempt to complete the transaction failed due to an error returned by an external provider (e.g., banking service or payment gateway). It is recommended to check the provider logs.
ERROR_IN_RECIPIENT_DATA	The recipient's data does not meet the minimum requirements or contains formatting errors. Validate mandatory fields and the expected structure.
USER_UNDER_REVIEW	The user's account has been flagged for manual review due to security reasons, identity verification, or regulatory compliance. No operations are allowed until the review is completed.
CANCELED_BY_RECIPIENT	The recipient actively canceled the transaction before the processing was completed. No retry will be attempted.
RECIPIENT_LIMIT_EXCEEDED	The recipient has reached the allowed funds reception limit for the current period. This validation may be subject to regulatory or internal policies.
SENDER_LIMIT_EXCEEDED	The sender has exceeded their daily, weekly, or monthly sending limit. Check current policies and update thresholds if applicable.
UNDELIVERABLE	The transaction could not be delivered to the recipient. This may be due to technical issues, a blocked account, or restrictions imposed by the destination provider.
ERROR_DELIVERY_NOTIFICATION_BY_PROVIDER	The external provider reported a failure in the delivery or confirmation of the transaction. This status usually requires manual review and validation with the provider’s support.