Skip to main content

Enrollment Cancel Reasons

EBANX supports a wide range of payment methods. This guide details the enrollment error and cancellation codes for methods that require a mandate setup before payment processing, such as Pix Automático and UPI Autopay.


Overview

When an enrollment status is not_accepted, expired or revoked, the response includes a specific reason that caused the enrollment's failure or termination. Understanding this reason is essential for diagnosing why the enrollment was canceled and identifying issues that might require resolution.

You can check an enrollment's status by using the /ws/userenrollments/query endpoint and referencing the merchant_enrollment_code.

The response will contain the latest status in status, the status_date with the timestamp of the last status change, the reason_code to categorize the cancel reason, and a description for more details.

   "enrollment": {
"status": "revoked",
"status_date": "2025-07-15 19:28:36",
"reason_code": "CANCELED_BY_MERCHANT",
"description": "Enrollment cancellation requested by the merchant"
}

List with response codes


reason_codedescription
CANCELED_BY_EBANXEBANX has canceled the enrollment
CANCELED_BY_MERCHANTEnrollment cancellation requested by the merchant
CANCELED_BY_PAYEREnrollment cancellation requested by the user
ENROLLMENT_ALREADY_ACCEPTEDThis enrollment was already confirmed
ENROLLMENT_CONFIRMATION_FAILUREIssue in enrollment confirmation by user bank
ENROLLMENT_DUPLICATEDEnrollment was already confirmed with another journey
ENROLLMENT_NOT_ACTIVEEnrollment is not active
FRAUD_PREVENTIONUser bank has canceled enrollment due to fraud prevention
INCORRECT_OTPOne time password not valid
INSTANT_PAYMENT_NOT_FOUNDEnrollment instant payment was not confirmed by the bank
INSUFFICIENT_FUNDS_OR_DAILY_LIMITInsufficient funds or limit restrictions in the user's account
INVALID_CARDThe card associated with this wallet is not valid
MERCHANT_COMPANY_CLOSEDMerchant company has closed
PAYER_DEATHPayer user has died
REJECTED_BY_USEREnrollment rejected by the user
TECHNICAL_ERRORThere is a technical issue, contact the support
USER_ACCOUNT_CLOSEDUser account is closed or blocked
USER_BANK_VALIDATION_ISSUESomething went wrong in user bank data validation
AUTHORIZATION_FAILED_RETRYABLEThe external service authorization failed. Please try again or use a different payment method.
DEFAULT_ERRORUnknown error

Still need help?

Help Image

We hope this article was helpful. If you still have questions, you can explore the following options: