# Code and Formats source: https://developer.mastercard.com/payment-acceptance-api/documentation/code-and-formats/index.md ## HTTP Response Codes {#http-response-codes} Resource requests use HTTP response codes to provide a coarse-grain indication of the result of each request. The most common expected response codes for the supported HTTP methods are as follows: | HTTP Response Code | Response Description | Resolution Tips | |----------------------------|---------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------| | 200 (OK) | The request was completed successfully. | No action needed - request processed successfully. | | 201 (CREATED) | Successful creation occurred using a POST request. The Location header will contain a link to the newly created resource. | No action needed - resource created successfully. Check Location header for new resource URL. | | 204 (NO CONTENT) | Successful update occurred using a PUT request. | No action needed - resource updated/deleted successfully. | | 400 (BAD REQUEST) | General error when the request could not be fulfilled due to errors such as validation errors or missing required data. | Validate request parameters, check required fields, and ensure proper data formats before retrying. | | 401 (UNAUTHORIZED) | Missing or invalid authentication token. | Verify authentication credentials, refresh tokens if expired, and ensure that proper authorization headers are included. | | 403 (FORBIDDEN) | The user has insufficient permissions to a resource or action. | Contact an administrator to verify user permissions or use an account with appropriate access rights. | | 404 (NOT FOUND) | The requested resource was not found. | Verify the resource URL/ID is correct and the resource exists. Check for typos in the endpoint path. | | 422 (UNPROCESSABLE ENTITY) | Resource already exists./Resource has been modified. | For duplicates: use PUT to update an existing resource. For modified resources: refresh data and retry with the latest version. | ## Gateway Error Codes {#gateway-error-codes} Apart from the error codes returned by the Payment Acceptance API, error codes can be returned by the Mastercard gateway, which verifies your request's signature and routes to the correct location. For further information about the 4xx response codes returned by the gateway and their possible resolutions, see [Gateway Error Codes](https://developer.mastercard.com/platform/documentation/security-and-authentication/gateway-error-codes/). ## Error Structure {#error-structure} To ensure a consistent experience across all Mastercard APIs, the following structure is followed by the Payment Acceptance API for each error scenario that can occur. **Single Error:** ```json { "Errors": { "Error": [ { "source": "", "recoverable": "e.g. true/false", "details": "One of the request parameters is invalid, try again with the correct request." } ] } } ``` **Multiple Errors:** ```json { "Errors": { "Error": [ { "Source": "", "ReasonCode": "", "Description": "", "Recoverable": "true/false", "Details": "" },{ "source": "", "description": "", "recoverable": "true/false", "Details": "" } ] } } ``` | Field | Description | |-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Source** | The application that generated this error. Every error message that is generated and returned by the Gateway will have this field set to `Gateway`. | | **ReasonCode** | A unique constant identifies the error case encountered when any Payment Acceptance API is called. For example, `FORBIDDEN` is used when the user has insufficient permissions to a resource or action. | | **Description** | Description of the `ReasonCode` field provided with additional details. | | **Recoverable** | Indicates whether this error will always be returned for this request, or retrying could change the outcome. For example, if the request contains an invalid request parameter, retrying will never result in success. However, if the error is related to some unexpected timeout with the service, retrying the call could result in a successful response. | | **Details** | Provide detailed error information wherever appropriate to help in resolving errors. | ## Payment Acceptance Request Error Codes {#payment-acceptance-request-error-codes} ### Payment Declined Request Error Codes {#payment-declined-request-error-codes} If the payment initiation status is `DECLINED`, you will receive one of the following reason codes. | Reason Code | Description | Tip to Resolve | |----------------------------------|-------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | FAILED | Transaction `{instructionIdentification}` has failed. | Retry the transaction once. If the failure persists, contact the card issuer or [CTS Commercial Team](mailto:CTS.Commercial@mastercard.com) for further investigation. | | INSUFFICIENT_FUNDS | Transaction `{instructionIdentification}` has failed due to insufficient funds. | Ask the cardholder to use a different card or ensure sufficient available balance before retrying. | | LOST_CARD | Transaction `{instructionIdentification}` has failed; this card was lost or stolen. | Do not retry the transaction. Ask the cardholder to contact the issuing bank and use an alternative payment method. | | REFER_TO_CARD_ISSUER | Transaction `{instructionIdentification}` has failed; referred to the issuing bank. | Ask the cardholder to contact their issuing bank for authorization before retrying the transaction. | | INVALID_MERCHANT | Transaction `{instructionIdentification}` has failed; invalid merchant. | Verify merchant ID and acquiring configuration. If correct, contact [CTS Commercial Team](mailto:CTS.Commercial@mastercard.com). | | CAPTURE_CARD | Transaction `{instructionIdentification}` has failed; capture card. | Do not retry. The cardholder must contact the issuing bank and use a different payment method. | | DO_NOT_HONOR | Transaction `{instructionIdentification}` has failed; do not honor. | Ask the cardholder to contact their issuing bank or retry using a different card. | | NOT_PERMITTED | Transaction `{instructionIdentification}` has failed; transaction not approved by the issuing bank. | Verify transaction type and merchant category. Ask the cardholder to contact the issuer if the issue persists. | | LIMIT_EXCEEDED | Transaction `{instructionIdentification}` has failed; issuing bank has restricted this card. | Ask the cardholder to reduce the transaction amount or contact the issuing bank to remove limits. | | INVALID_ISSUER | Transaction `{instructionIdentification}` has failed; card issuer not recognized. | Verify card number and BIN configuration. If valid, retry or contact [CTS Commercial Team](mailto:CTS.Commercial@mastercard.com). | | NO_REPLY | Transaction `{instructionIdentification}` has failed; unable to reach issuing bank. | Retry the transaction after some time. If the issue continues, contact [CTS Commercial Team](mailto:CTS.Commercial@mastercard.com). | | PROCESSOR_DOWN | Transaction `{instructionIdentification}` has failed; system down. | Retry the transaction after some time once the processor is available. | | SUPPLIER_BANK_NOT_FOUND | Transaction `{instructionIdentification}` has failed; supplier bank not found. | Verify supplier bank details. Correct the data and retry the transaction. | | BANK_ACC_FAILURE | Transaction `{instructionIdentification}` has failed; supplier bank did not accept the transaction. | Confirm supplier bank account details and retry. Contact the supplier bank if required. | | ALT_MOP | Transaction `{instructionIdentification}` has failed; supplier bank did not accept the transaction. | Retry using an alternative method of payment supported by the supplier. | | INVALID_TRANSACTION | Transaction `{instructionIdentification}` has failed; invalid transaction. | Verify transaction parameters and request format, then retry. | | INVALID_AMOUNT | Transaction `{instructionIdentification}` has failed; invalid amount. | Ensure the transaction amount is valid, non-zero, and within permitted limits. | | INVALID_CARD_NUMBER | Transaction `{instructionIdentification}` has failed; invalid card number. | Verify the card number and retry with a valid card. | | STOLEN_CARD | Transaction `{instructionIdentification}` has failed; card reported stolen. | Do not retry. Ask the cardholder to contact the issuer and use a different card. | | EXPIRED_CARD | Transaction `{instructionIdentification}` has failed; expired card. | Use a valid and non-expired card. | | RESTRICTED_CARD | Transaction `{instructionIdentification}` has failed; issuing bank has restricted this card. | Ask the cardholder to contact the issuing bank or use another card. | | SECURITY_VIOLATION | Transaction `{instructionIdentification}` has failed; CVV/CVC/CID was incorrect. | Verify CVV/CVC/CID and retry with correct security details. | | NO_CVV | Card Verification Value is required. | Provide a valid CVV (3--4 digits) as per the API specification and retry. | | BUYER_BANK_NOT_FOUND | Transaction `{instructionIdentification}` has failed; buyer bank not found. | Verify buyer bank details and retry. Contact support if configuration is correct. | | ALT_MOP_NOT_CDP | Transaction `{instructionIdentification}` has failed; supplier does not accept CDP payment from this buyer. | Use a supported payment method or update supplier--buyer payment configuration. | | UNSUPPORTED_CURRENCY_BY_SUPPLIER | `{instructionIdentification}` has failed; supplier does not accept selected currency. | Retry using a currency supported by the supplier. | | NO_PARTIAL_PAYMENT | Supplier does not accept partial payments. | Submit the full payment amount or confirm supplier payment rules before retrying. | | CONTACT_CARD_ISSUER | Transaction `{instructionIdentification}` has failed; contact card issuer. | Ask the cardholder to contact their issuing bank before retrying the transaction. | | DUPLICATE_TRANSMISSION | Transaction `{instructionIdentification}` has failed; duplicate transmission detected. | Ensure the transaction is not resent with the same identifiers. Generate a new request and retry. | | INVALID_CVV | Invalid Card Verification Value. | Provide a valid CVV (3--4 digits) and retry the transaction. | | AMOUNT_LIMIT_EXCEEDED | Transaction `{instructionIdentification}` has failed; withdrawal amount limit exceeded. | Reduce the transaction amount or ask the cardholder to contact the issuing bank. | | COUNT_LIMIT_EXCEEDED | Transaction `{instructionIdentification}` has failed; withdrawal count limit exceeded. | Retry later or ask the cardholder to contact the issuing bank to reset limits. | ### Payment Rejected Request Error Codes {#payment-rejected-request-error-codes} If the payment initiation status is `REJECTED`, you will receive one of the following reason codes. | Reason Code | Description | Tip to Resolve | |----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------| | SUPPLIER_SYSTEM_DOWN | The Supplier cannot be reached. Try again later. | Retry the transaction after some time once the supplier system is available. | | SUPPLIER_ACCT_NOT_FOUND | Unable to find an updated and accurate account number for the supplier. | Verify and update the supplier account details before retrying the transaction. | | ACCOUNT_CLOSED | The supplier's account has been closed. | Confirm the supplier account status and use an active account or alternate supplier details. | | NO_PARTIAL_PAYMENT | Supplier `{supplierId}` will not accept partial payments at this time. | Submit the full payment amount as required by the supplier. | | ALT_MOP | Transaction `{instructionIdentification}` has failed. `{buyerId}` needs to use an alternative method of payment for transacting to `{supplierId}`. | Retry the transaction using an alternative payment method supported by the supplier. | | ALT_MOP_NOT_CDP | Transaction `{instructionIdentification}` has failed. `{supplierId}` does not accept Commercial Direct Payments from this `{buyerId}`. | Use a supported payment method or update the buyer--supplier payment configuration. | | UNSUPPORTED_CURRENCY_BY_SUPPLIER | `{instructionIdentification}` has failed. The Supplier does not accept the selected currency. | Retry the transaction using a currency supported by the supplier. | | INVOICE_NOT_SUPPORTED | Transaction `{instructionIdentification}` is rejected. The accepting Supplier Payment Agent does not support one or more invoices. | Remove unsupported invoices and retry with supported invoice types only. | | INVALID_INVOICE_DATA | Transaction `{instructionIdentification}` is rejected. One or more invoices include information that creates a reconciliation mismatch for the accepting Supplier Payment Agent. | Validate and correct invoice details to meet the Supplier Payment Agent's reconciliation requirements. | | INVALID_CREDIT_NOTE_DATA | Transaction `{instructionIdentification}` is rejected. One or more credit notes include information that creates a reconciliation mismatch for the accepting Supplier Payment Agent. | Correct the credit note details to align with the associated invoices before retrying. | | BUYER_NOT_REGISTERED_WITH_SPA | Card verification Value is required. Please use a valid Card Verification Value numerical minimum length is 3 and maximum length is 4. | Ensure the buyer is registered with the Supplier Payment Agent before submitting the transaction. | | NO_CVV | Card verification Value is required. Please use a valid Card Verification Value numerical minimum length is 3 and maximum length is 4. | Provide a valid CVV (3--4 digits) in the request and retry the transaction. | ### Cancellation Rejected Request Error Codes {#cancellation-rejected-request-error-codes} When the cancellation request is rejected, you may receive one or more of the following error codes either if the required data is missing or if the data you provided is incorrect. | Reason Code | Description | Tip to Resolve | |------------------------|--------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------| | CARD_DEBITED | Transaction `{instructionIdentification}` cancellation rejected. The card was debited for the `{instructionIdentification}` already. | Verify that the transaction has already been processed and reconcile the payment instead of attempting cancellation. | | PAYMENT_PROCESSED | Transaction `{instructionIdentification}` cancellation rejected. `{paymentMethod}` payment was processed already. | Confirm the successful payment status and avoid retrying the cancellation request. | | CANNOT_HONOR_REQUEST | Transaction `{instructionIdentification}` cancellation rejected. Supplier cannot honor the request. | Coordinate with the supplier to understand the rejection reason before taking further action. | | FAILED | Transaction `{instructionIdentification}` has failed. | Ensure that the `` is today or a future date, then retry the transaction. | | NOT_PERMITTED | Transaction `{instructionIdentification}` has failed, transaction not approved by the issuing Bank. | Verify card details and transaction parameters before retrying, or ask the cardholder to contact the issuing bank. | | NO_REPLY | Transaction `{instructionIdentification}` has failed, unable to reach issuing Bank. | Retry the transaction after some time once the issuing bank is reachable. | | PROCESSOR_DOWN | Transaction `{instructionIdentification}` has failed, system down. | Retry the transaction after the processor system becomes available. | | CAPTURE_CARD | Transaction `{instructionIdentification}` has failed, capture card. | Do not retry the transaction; request the cardholder to use a different card or payment method. | | DO_NOT_HONOR | Transaction `{instructionIdentification}` has failed, do not honor. | Ask the cardholder to contact the issuing bank or use an alternative card. | | INVALID_TRANSACTION | Transaction `{instructionIdentification}` has failed, invalid transaction. | Verify transaction details and ensure the `` is today or in the future before retrying. | | SECURITY_VIOLATION | Transaction `{instructionIdentification}` has failed, three-digit CVV2 or CVC or the four-digit CID security code was incorrect. | Enter the correct CVV2, CVC, or CID security code and retry the transaction. | | DUPLICATE_TRANSMISSION | Transaction `{instructionIdentification}` has failed, duplicate transmission detected. | Check transaction history to ensure the request was not already submitted, then retry with a new transaction if required. | | SPA_SYSTEM_ERROR | Transaction `{instructionIdentification}` cancellation rejected. System error from supplier. | Retry the cancellation request after some time or coordinate with the supplier to resolve the system issue. | ## Payment Acceptance Response Error Codes {#payment-acceptance-response-error-codes} | Reason Code | Description | Tip to Resolve | |------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------| | `FAILED` | Transaction `{instructionIdentification}` has failed. | Retry the transaction or contact the issuing bank for further details. | | `INSUFFICIENT_FUNDS` | Transaction `{instructionIdentification}` has failed due to insufficient funds. | Ensure sufficient funds are available before retrying the transaction. | | `LOST_CARD` | Transaction `{instructionIdentification}` has failed; this card was lost or stolen. | Use a valid card that has not been reported lost or stolen. | | `REFER_TO_CARD_ISSUER` | Transaction `{instructionIdentification}` has failed; referred to the issuing bank. | Contact the issuing bank to authorize or approve the transaction. | | `INVALID_MERCHANT` | Transaction `{instructionIdentification}` has failed; invalid merchant. | Verify that the merchant information is valid and correctly configured. | | `CAPTURE_CARD` | Transaction `{instructionIdentification}` has failed; capture card. | Contact the issuing bank and request guidance before retrying. | | `DO_NOT_HONOR` | Transaction `{instructionIdentification}` has failed; do not honor. | Contact the issuing bank to understand the rejection reason. | | `NOT_PERMITTED` | Transaction `{instructionIdentification}` has failed; transaction not approved by the issuing bank. | Confirm with the issuing bank that the transaction type is permitted. | | `LIMIT_EXCEEDED` | Transaction `{instructionIdentification}` has failed; issuing bank has restricted this card. | Verify card limits with the issuing bank or reduce the transaction amount. | | `INVALID_ISSUER` | Transaction `{instructionIdentification}` has failed; card issuer not recognized. | Verify issuer details and ensure the card is supported. | | `NO_REPLY` | Transaction `{instructionIdentification}` has failed; unable to reach issuing bank. | Retry the transaction after some time or contact the issuing bank. | | `PROCESSOR_DOWN` | Transaction `{instructionIdentification}` has failed; system down. | Retry the transaction once the system is available. | | `CREDITOR_BANK_NOT_FOUND` | Transaction `{instructionIdentification}` has failed; Creditor bank not found. | Verify creditor bank details and resubmit the transaction. | | `BANK_ACC_FAILURE` | Transaction `{instructionIdentification}` has failed; Creditor's bank did not accept the transaction. | Confirm creditor bank acceptance and retry the transaction. | | `ALT_MOP` | Transaction `{instructionIdentification}` has failed; Creditor's bank did not accept the transaction. | Use an alternate method of payment supported by the creditor. | | `INVALID_AMOUNT` | Transaction `{instructionIdentification}` has failed; invalid amount. | Validate the transaction amount and submit a corrected request. | | `INVALID_CARD_NUMBER` | Transaction `{instructionIdentification}` has failed; invalid card number. | Verify the card number and retry the transaction. | | `STOLEN_CARD` | Transaction `{instructionIdentification}` has failed; this card was reported stolen. | Use a replacement card issued by the bank. | | `EXPIRED_CARD` | Transaction `{instructionIdentification}` has failed; expired card. | Use a card with a valid expiration date. | | `RESTRICTED_CARD` | Transaction `{instructionIdentification}` has failed; issuing bank has restricted this card. | Contact the issuing bank to remove restrictions or use another card. | | `DEBTOR_BANK_NOT_FOUND` | Transaction `{instructionIdentification}` has failed; Debtor bank not found. | Verify debtor bank details and retry the transaction. | | `ALT_MOP_NOT_CDP` | Transaction `{instructionIdentification}` has failed; `{supplierId}` does not accept CDP payment from `buyerId`. | Use a payment method accepted by the supplier. | | `UNSUPPORTED_CURRENCY_BY_CREDITOR` | `{instructionIdentification}` has failed; the Creditor does not accept the selected currency. | Select a currency supported by the creditor and retry. | | `NO_PARTIAL_PAYMENT` | Creditor `{supplierId}` will not accept partial payments at this time. | Submit the transaction for the full payable amount. | | `CONTACT_CARD_ISSUER` | Transaction `{instructionIdentification}` has failed; contact issuing bank. | Contact the issuing bank to resolve the issue before retrying. | | `INVALID_CVV` | Invalid Card Verification Value. Use a valid CVV (3--4 digits). | Enter a valid CVV and resubmit the transaction. | | `AMOUNT_LIMIT_EXCEEDED` | Transaction `{instructionIdentification}` has failed; exceeds withdrawal amount limit. | Reduce the transaction amount or request a limit increase. | | `COUNT_LIMIT_EXCEEDED` | Transaction `{instructionIdentification}` has failed; exceeds withdrawal count limit. | Retry after the limit resets or contact the issuing bank. | | `CREDITOR_SYSTEM_DOWN` | The Creditor cannot be reached. Try again later. | Retry the transaction once the creditor system is available. | | `CREDITOR_ACCT_NOT_FOUND` | Unable to find an updated and accurate account number for the Creditor. | Verify the creditor account details and resubmit. | | `ACCOUNT_CLOSED` | The Creditor's account has been closed. | Confirm account status with the creditor and use an active account. | | `INVOICE_NOT_SUPPORTED` | Transaction `{instructionIdentification}` is rejected. The Creditor Payment Agent does not support one or more invoices. | Remove unsupported invoices and retry the transaction. | | `INVALID_INVOICE_DATA` | Transaction `{instructionIdentification}` is rejected. One or more invoices contain information that creates reconciliation mismatch. | Correct the invoice data and resubmit the request. | | `INVALID_CREDIT_NOTE_DATA` | Transaction `{instructionIdentification}` is rejected. One or more credit notes contain information that creates reconciliation mismatch. | Correct the credit note data as per the API Reference. | | `DEBTOR_NOT_REGISTERED_WITH_SPA` | Card Verification Value is required. Use a valid CVV (3--4 digits). | Ensure the debtor is registered and provide the required CVV. | | `NO_CVV` | Card Verification Value is required. Use a valid CVV (3--4 digits). | Include a valid CVV in the request payload. | | `CARD_DEBITED` | Transaction `{instructionIdentification}` cancellation rejected. The card was already debited for `{instructionIdentification}`. | Do not retry cancellation once the transaction is debited. | | `PAYMENT_PROCESSED` | Transaction `{instructionIdentification}` cancellation rejected. `{paymentMethod}` payment was already processed. | Reconcile the processed payment instead of retrying cancellation. | | `CANNOT_HONOR_REQUEST` | Transaction `{instructionIdentification}` cancellation rejected. Creditor cannot honor the request. | Contact the creditor to understand the rejection reason. | | `INVALID_TRANSACTION` | Transaction `{instructionIdentification}` has failed; invalid transaction. | Validate transaction details and ensure they meet processing rules. | | `SECURITY_VIOLATION` | Transaction `{instructionIdentification}` has failed; CVV2/CVC/CID security code was incorrect. | Enter the correct security code and retry the transaction. | | `DUPLICATE_TRANSMISSION` | Transaction `{instructionIdentification}` has failed; duplicate transmission detected. | Ensure the transaction is not resubmitted multiple times. | | `SPA_SYSTEM_ERROR` | Transaction `{instructionIdentification}` cancellation rejected; system error from Creditor. | Retry the request later or contact support if the issue persists. | | `CREDITOR_PROFILE_ID_EXISTS` | Enter a different Creditor Profile ID, `CREDITOR_PROFILE_ID_EXISTS` already exists. | Use a unique Creditor Profile ID that is not assigned to another profile. | | `INVALID_CREDITOR_PROFILE_ID_FORMAT` `NO_CREDITOR_PROFILE_ID` | Enter Creditor profile ID in the format `@`. | Correct the request based on the description provided. | | `NO_PAYMENT_PROFILE` | Payment Profile is required. Please provide at least one Payment Profile. | Enter at least one payment profile. | | `DUPLICATE_EMAIL` | Enter a different email address. This email is already in use with a different payment profile. | Verify and enter the correct email address. | | `INVALID_LEGAL_BUSINESS_NAME` `INVALID_DBA_NAME` | Enter a Name with 240 characters or less. | Review the field value and correct it according to the specification. | | `INVALID_LEGAL_ADDRESS_LINE` `INVALID_PAY_TO_ADDRESS_LINE` | Enter Address Line with 140 characters or less. | Enter a valid Address Line as per the specified limit. | | `INVALID_LEGAL_ADDRESS_TOWN_NAME` `INVALID_PAY_TO_ADDRESS_TOWN_NAME` | Enter a Town Name with 140 characters or less. | Enter a valid Town Name as per the specified limit. | | `INVALID_LEGAL_ADDRESS_COUNTRY_SUBDIVISION` `INVALID_PAY_TO_ADDRESS_COUNTRY_SUBDIVISION` | Enter a Country SubDivision with 35 characters or less. | Enter a valid Country SubDivision with 35 characters or less. | | `INVALID_ORGANISATION_ID_TYPE` | Enter a valid Organisation Identification Type. | Check and retry with a valid Organisation Identification Type. | | `BUSINESS_EXISTS` | This business already exists for this agent. | Update the existing profile or register with a different identifier. | | `INVALID_PAYMENT_METHOD` | Enter a method supported by the Debtor/Creditor and agent. Valid value: `CARD`. | Enter valid payment method value as `CARD`. | | `INVALID_TAX_ID` | **NAM** US: Enter a valid Tax ID with 9 digits. Canada: Enter a valid Tax ID with 9 digits. **EUR** UK: Enter a valid Tax ID with 10 digits. **LAC** Curacao: Enter a valid Tax ID with 9 digits. Colombia: Enter a valid Tax ID with 9 or 10 digits. Brazil: Enter a valid Tax ID with 14 digits. **Other** All other countries: (optional): Enter a valid Tax ID with 15 digits. | Enter a valid Tax ID per country-specific format. | | `NO_LEGAL_ADDRESS_LINE` `NO_PAY_TO_ADDRESS_LINE` | Enter Address Line with 140 characters or less. | Enter a valid Address Line with 140 characters or less. | | `NO_LEGAL_ADDRESS_TOWN_NAME` | Enter a Town Name with 140 characters or less. | Enter a valid Town Name with 140 characters or less. | | `NO_LEGAL_ADDRESS_COUNTRY_SUBDIVISION` | Enter a Country SubDivision with 35 characters or less. | Enter a valid Country SubDivision with 35 characters or less. | | `NO_LEGAL_ADDRESS_POSTCODE` `NO_PAY_TO_ADDRESS_POSTCODE` | **NAM** US: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. Canada: Enter a valid Post Code with 5 to 8 characters. Spaces or hyphens are allowed. **EUR** UK: Enter a valid Post Code with 6 to 8 characters. Spaces or hyphens are allowed. **LAC** Curacao(optional): Enter a valid Post Code up with 10 characters or less. Spaces or hyphens are allowed. Colombia: Enter a valid Post Code with 7 digits. Spaces or hyphens are allowed. Brazil: Enter a valid Post Code with 5 to 10 digits. Spaces or hyphens are allowed. **Other** All other countries: (optional): Enter a valid Post Code with 10 characters or less. Spaces or hyphens are allowed. | Enter a valid postcode per regional format. | | `NO_LEGAL_ADDRESS_COUNTRY` `NO_PAY_TO_ADDRESS_COUNTRY` | Enter country code in two‑letter code format. | Enter a valid two‑letter country code. | | `NO_LEGAL_ADDRESS` | Address is required. | Correct the request based on the description provided. | | `LEGAL_ADDRESS_SANCTIONED_COUNTRY` | Enter a different country. The country used in the request is sanctioned and cannot be used. | Select a non‑sanctioned country per compliance policy. | | `INVALID_DUNS` | Enter a valid Data Universal Numbering System with 15 characters or less. | Provide a valid value as required by the API. | | `INVALID_CUST` | Enter a valid Customer Number with 15 characters or less. | Provide a valid value as required by the API. | | `INVALID_CBID` | Enter a valid Central Bank Identification with 15 characters or less. | Provide a valid value as required by the API. | | `INVALID_COID` | Enter a valid Country Identification Code with 15 characters or less. | Provide a valid value as required by the API. | | `INVALID_COID_UPDATE` | The Country Identification Code cannot be updated. A Country Identification Code already exists for this Debtor. | Correct the request based on the description provided. | | `UNIDENTIFIED_FIELD` | `Field Name` is an unidentified field. Check the request schema. | Correct the request based on the description provided. | | `INVALID_PROFILE_STATE` | Enter a valid value for the `is_active` flag for the payment profile. Payment profile cannot be active when Creditor is inactive. | Provide a valid value as required by the API. | | `INVALID_INACTIVE_REASON` | Enter a valid inactive reason. Valid values are PRE_REGISTERED and AGENT_HOLD. | Provide a valid value as required by the API. | | `NO_PAY_TO_ADDRESS_COUNTRY_SUBDIVISION` | Enter a Country SubDivison with 35 characters or less. | Correct the request based on the description provided. | | `NO_TAX_ID` | Enter a Tax ID for an Organisation. | Correct the request based on the description provided. | | `NO_PAY_TO_ADDRESS_TOWN_NAME` | Enter a Town Name with 140 characters or less. | Correct the request based on the description provided. | | `NO_LEGAL_BUSINESS_NAME` | Enter a Name with 240 characters or less. | Correct the request based on the description provided. | | `INVALID_EMAIL` | Enter a valid email address. Ensure that the format includes \[username\]@\[domain\].\[top level domain\]. | Provide a valid value as required by the API. | | `NO_ORGANISATION_IDENTIFICATION` | Enter one or more valid Organisation Identifications. | Provide a valid value as required by the API. | | `INVALID_REGISTRATION_ID` | Enter a valid Creditor registration ID. `ID` is either not valid or is not associated to your profile. | Enter a valid Creditor registration ID. | | `API_DOWN` | This CDP API is down. Try again later. | Check and retry after some time. | | `INVALID_BANK` | Enter a valid Bank Party Identification with 15 characters or less. | Enter a valid Bank Party Identification. | | `INVALID_LIMIT` | Set the limit to 100 records or less for this request. You can only retrieve 100 records at a time. | Retry with a limit of 100 records or less. | | `PROFILE_ALREADY_PRESENT` | Profile ID already exists. | Verify and enter correct Profile ID. | | `MISSING_PROFILE_ID` | Profile ID is required. | Enter a valid Profile ID. | | `CREDITOR_ID_NOT_FOUND` | Enter a valid Creditor ID. Creditor ID was not found. | Enter a valid Creditor ID. | | `PAYMENT_PROFILE_LIMIT_EXCEEDED` | Remove one or more profiles. The total number of profiles associated with a Creditor cannot exceed 20. | Remove one or more profiles. | | `NO_PAYMENT_METHOD` | Payment method is missing. Enter one or more supported methods. | Provide one or more payment methods supported by the Debtor/Creditor and agent. Valid: CARD. | | `PAY_TO_ADDRESS_SANCTIONED_COUNTRY` | The country used in the request is sanctioned and cannot be used. | Select a non‑sanctioned country. | | `INVALID_PROFILE_STATE_UPDATE` | Enter a valid value for `is_active` flag. Creditor cannot be inactive when payment profile is active. | Enter a valid `is_active` value. | | `INVALID_COUNTRY_UPDATE` | A Legal Address Country exists for this Creditor. The Legal Address Country cannot be updated. | Verify that the originally submitted country value is correct before submitting the request. | | `INVALID_TAX_ID_UPDATE` | A Tax ID already exists for this Creditor. The Tax ID cannot be updated. | Enter a valid Tax ID if creating a new record; updating is not allowed. | | `INVALID_DELETE_PROFILE_REQUEST` | Mastercard CDP cannot process the delete profile request. Each active Debtor or Creditor must have at least one payment profile. | Ensure at least one active payment profile remains associated with the Debtor or Creditor. | | `CREDITOR_PROFILE_ID_NOT_EXIST` | Creditor Profile ID does not exist. | Verify and enter a valid Creditor Profile ID. | | `INVALID_CONTROLS_DECISION` | Enter a valid control decision, such as REJECT or WARNING. | Ensure you have entered a valid control decision. | | `INVALID_MAX_INSTRUCTED_AMT` | Enter a valid maximum instructed amount value. | Ensure you have entered a valid maximum instructed amount value. | | `INVALID_MIN_INSTRUCTED_AMT` | Enter a valid minimum instructed amount value. | Ensure you have entered a valid minimum instructed amount value. | | `INVALID_CHARGES_PERCENTAGE_AMT` | Enter a valid charges percentage amount. | Ensure you have entered a valid charges percentage amount. | | `INVALID_CHARGES_FLAT_AMT` | Enter a valid charges flat amount. | Ensure you have entered a valid charges flat amount. | | `EXISTING_CONTROL` | There is an existing control for CARD on this Creditor ID. | Verify and enter valid control. | | `INSTRUCTED_MIN_GREATER_MAX` | The minimum instructed amount value cannot be greater than or equal to the maximum instructed amount value. | Ensure that the minimum instructed amount value is less than the maximum instructed amount. | | `INVALID_INCL_EXCL_CONTROL` | Invalid control relationship. There cannot be both an include and exclude relationship setting on the same control. | Choose include or exclude, not both. | | `INVALID_MIN_MAX_INSTRUCTED_AMT` | Enter a valid maximum and minimum instructed amount value. There cannot be both the same value for maximum and minimum instructed amounts. | Enter a valid maximum and minimum instructed amount value. | | `INVALID_REFERRED_DOCUMENT_TYPE` | Enter a valid referred document type. | Ensure you have entered a valid referred document type. | | `INVALID_ORGANISATION_IDENTIFICATION_TYPE` | Enter a valid organisation identification type. | Ensure you have entered a valid organisation identification type. | | `MISSING_MAX_DAYS_AFTER_RELATED_DATE` | Max days after related date is required with referred document type. | Ensure you have entered a valid max days after related date. | | `DUPLICATE_REFERRED_DOCUMENT_TYPE` | Only one condition allowed for each referred document type. | Verify the referred document type and retry. | | `NO_EXISTING_CONTROLS` | Creditor Payment Controls could not be found. | Verify the Creditor Payment Controls and retry. | | `INVALID_CHARGES_CONDITION` | Both charges percentage and charges flat amount cannot be used in the same control at the same time. | Choose one charges type (percentage or flat amount) per control. | | `MISSING_CONTROL_ID` | Enter a valid Control ID. | Ensure you have entered a valid Control ID. | | `CONTROL_ID_NOT_EXIST` | Control ID does not exist. | Enter a valid Control ID. | | `DEBTOR_PROFILE_ID_NOT_FOUND` | Debtor Profile ID is not found. | Enter a valid Debtor Profile ID. |