added

New Error Codes for Payments Processing Platform

There will be new error codes for Maya’s Payment Processing Platform which will be rollout on October 24, 2022.

The new P3-generated error codes will segregate the existing ACQ084 error code into the following errors:

Existing Error CodeProposed Error CodeMessage
ACQ084ACQ504Issuer instructed to stop authorization requests for this card. Please retry the transaction using a different card.
ACQ084ACQ505Issuer Decline Limit Exceeded - Please retry this card after 24 hours or retry the transaction using a different card.
ACQ084ACQ506Card networks prohibit further authorization requests for this card. Please retry the transaction using a different card.
ACQ084ACQ507Please validate your card expiry date and retry the transaction.
ACQ084ACQ508Please validate your card number and expiry date, then retry the transaction.
ACQ084ACQ084Transaction was blocked by the Acquirer

Note: ACQ084 will still be used for errors not classified to the 5 new error codes listed above.

Sample Error JSON

{
    "logref": "906c2d36-48a1-40ed-84c0-806403672030",
    "code": "ACQ504",
    "message": "[ACQ504] Issuer instructed to stop authorization requests for this card. Please retry the transaction using a different card.",
    "receiptNo": "806403672030",
    "links": [
      {
        "rel": "self",
        "href": "https://cdn.paymaya.com/sandbox/payments_api/paymayap3/paymayap3.html"
      }
    ]
  }

What does this mean for you as developers?

  • If you have special handling for ACQ084 errors in place (i.e. error logs), you might notice a reduction of ACQ084 codes due to introduction of the new 5 codes.
  • For transactions rejected with ACQ504, ACQ505 and ACQ506 error code, you may opt to add validations of your own to preemptively decline transactions fitting for each of those scenarios.

For any questions or concerns, please contact us through our support channels.