Choose the Documentation MX Merchant MX Connect

Recurring Transaction Error Codes

Diagnose and handle errors when creating or managing recurring transactions.

This section outlines error codes and messages for Recurring transaction operations, creating a schedule and updating, pausing, resuming, cancelling, or deleting it. Each error provides a standardized code and description to help identify the issue and handle it. These apply to the schedule itself; a transaction a schedule generates returns the codes on Transaction Error Codes.

Error CodeError MessageCondition
EC-VA-0005"field": "<field-name>", "message": "Is required."A mandatory field was not passed in the request.
EC-BL-9913endDate should be greater than startDateThe endDate must be later than the startDate.
EC-BL-0049externalId cannot be updated.externalId can't be changed once set.
EC-BL-0066Can not update transactionDetail.startDate / Can not update transactionDetail.frequencystartDate can't be updated (once transactions exist), and frequency can't be updated at all.
EC-BL-9915Total number of processed occurrences are greater than the requested count for occurrences.You can't lower occurrence below the number already processed.
EC-BL-9905transactionDetail.<dayOfMonth|dayOfWeek|monthOfYear> is not allowed to pass in the requests if the frequency is <frequency>.A day/month field was passed that isn't allowed for the chosen frequency (for example dayOfMonth with WEEK, or any of them with CALENDAR_DAY/BUSINESS_DAY).
EC-BL-9906action[0].transaction.sourcesource is mandatory and can't be null.
EC-BL-9906action[0].transaction.destination.iddestination is mandatory and can't be null.
EC-BL-9906action[0].transaction.source.externalAccount.id or ...externalIdProvide id or externalId for the external account.
EC-BL-9908Recurring Transaction id <id> can be updated only in the ACTIVE/PAUSED status. (and DELETED / CANCELED / paused / resumed variants; resumeOn date should be less than endDate.)The requested action isn't allowed from the schedule's current status, or resumeOn falls on or after endDate.
EC-BL-0004Recurring Transaction id <id> does not exist.The schedule id doesn't exist for this customer.
EC-BL-9911Recurring Transaction id <id> can be DELETED only if no transactions is created/processed till dateYou can't delete a schedule that has already generated a transaction; cancel it instead.
EC-BL-1301A comment is required when you specify reason as 'Others' for the requested action.Pausing or cancelling with reason: OTHERS requires a comment.
EC-BL-9977<value> is not an accepted currency for the International External Account <id>The currency isn't supported by the international external account.
EC-BL-9999Only USD is supported as currency.The international external account supports USD only.