Maya ONE App Decline Codes: Merchant Configuration and Setup Issues

Overview

These errors indicate merchant setup, onboarding, or configuration issues in Maya’s Payment Gateway.

Developers should verify the merchant ID, slug, or configuration through the partner portal or Maya Support.

Note: The error or decline code is only prompted in the Maya Terminal, where the Maya ONE App is installed.

For ECR-integrated setup, Maya Terminal sends a decline response, with a command status R for Rejected, to the connected Electronic Cash Register (ECR).

---

Declines Requiring Merchant Config Checks

Merchant ID Does Not Exist

Cause and Impact:

The merchant’s MID (Merchant ID) is not onboarded or registered in the system.

The transaction cannot proceed until the correct MID is configured.

Possible Maya ONE App Error:

Recommended handling:

Verify the merchant onboarding status and ensure that the correct MID is being used.

---

Merchant Not Configured Properly

Cause and Impact:

The merchant setup is incomplete or incorrectly configured in the PayMaya system. This issue prevents transaction authorization.

Possible Maya ONE App Error:

Recommended handling:

Contact PayMaya Support to validate and correct the merchant configuration.

---

Merchant Slug Missing

Cause and Impact:

The merchant slug (unique identifier) was not provided in the transaction request. The system cannot identify the merchant, causing the transaction to fail.

Possible Maya ONE App Error:

Recommended handling:

Include the correct merchant slug in the transaction request.

---

Merchant Reference Number Missing

Cause and Impact:

The merchant reference number (RefNo) was not included in the transaction request. Without this reference, the transaction cannot be processed or tracked.

Possible Maya ONE App Error:

Recommended handling:

Provide a valid merchant reference number in the request.

---

Incorrect Payment Facilitator Details (Non-PF Merchant)

Cause and Impact:

The merchant is not registered as a Payment Facilitator (PF), but PF details were included in the request. The system rejects the request as invalid.

Possible Maya ONE App Error:

Recommended handling:

Remove unnecessary Payment Facilitator details or update the merchant configuration.

---

Missing Payment Facilitator Details (PF Merchant)

Cause and Impact:

The merchant is registered as a Payment Facilitator (PF), but PF details were missing in the request. The transaction cannot proceed without the required PF information.

Possible Maya ONE App Error:

Recommended handling:

Include the required Payment Facilitator details in the transaction request.

---

Invalid Merchant Configuration

Cause and Impact:

The merchant configuration in the acquiring system is invalid.

The system cannot process transactions under this configuration.

Possible Maya ONE App Error:

Recommended handling:

Verify and confirm with [email protected]that the merchant is configured correctly.

---

Merchant Account Validation Error

Cause and Impact:

The merchant details in the transaction request are incomplete or incorrect.

The transaction cannot be authorized.

Possible Maya ONE App Error:

Recommended handling:

Validate merchant account details and retry the transaction.

---

Invalid Merchant

Cause and Impact:

The merchant is unrecognized or invalid according to issuer validation.

The transaction request is rejected.

Possible Maya ONE App Error:

Recommended handling:

Verify the merchant configuration and retry once the setup is corrected.

---

FAQs

Q: Are the Merchant config or setup issues caused by the bank or the card issuer?

A: No. These are merchant-side or acquirer-side issues, typically due to an incorrect Merchant ID (MID), Terminal ID (TID), missing Payment Facilitator details, or unregistered merchant setup.

Q: Can I fix Merchant config or setup issues from the terminal or ECR app?

A: No. Configuration errors must be validated by Maya Business Support or your account manager. However, you can check if the correct Merchant ID, configuration files, and credentials are being used.

Q: What is the most common cause of merchant configuration declines?

A: Common causes include:

• The Merchant ID (MID) or Terminal ID (TID) is not onboarded or linked correctly.
• The merchant slug or reference number is missing.
• The ECR plugin or integration parameters don’t match the registered merchant details.
• Payment Facilitator (PF) details are missing or incorrectly included.

Q: Can I retry the transaction after getting this error?

A: Retrying will not resolve the issue unless the configuration is corrected. You must confirm the merchant setup with Maya Support before reattempting transactions.

---

Next Steps

When encountering Merchant Configuration & Setup declines:

1. Review Merchant Information
   • Verify that the Merchant ID (MID) and Terminal ID (TID) match the ones issued by Maya.
   • Check that the merchant is onboarded and active in the system.
2. Inspect ECR Configuration Parameters
   • Ensure that the specifications are correctly set in the ECR app or integration.
3. Validate Integration Files
   • Make sure that the correct configuration files, environment URLs, and credentials are in use.
   • If the issue persists, reinstall or reconfigure the merchant profile in the ECR or POS app.
4. Coordinate with Maya Business Support
   • Email [email protected] providing the following details:
     • Terminal Type (Sunmi / PAX / PAX Lite)
     • Merchant and Terminal IDs
     • Error message or code displayed
     • Screenshot or log extract from the ECR or Maya terminal
5. Confirm Resolution Before Retrying
   • Wait for confirmation that your merchant setup has been corrected or activated before reattempting a transaction.