Errors

Keep calm and read the error message

Maya Business Payment Solutions API is RESTful and uses HTTP response and codes to inform clients of success or failure of requests.

Error responses are returned in JSON format.

{
    "code": "PY0009",
    "message": "Payment does not exist.",
}

Other errors with a 2553 code in its response body will have parameters which is an array of objects for invalid fields.

{
    "code": "2553",
    "message": "Missing/invalid parameters.",
    "parameters": [
        {
            "description": "value must be a number",
            "field": "totalAmount.value"
        },
        {
            "description": "A valid currency is required.",
            "field": "totalAmount.currency"
        }
    ]
}

Common HTTP errors

HTTP Status

Code

Message

Description

400

2553

Missing/invalid parameters.

400

PY9999

Payment Vault is unreachable / timed out.

400

PY0001

A problem is encountered. Please contact your system administrator.

Generic error please contact support if you encounter this.

400

PY0002

Card is expired.

400

PY0007

Invalid token status.

400

PY0008

Token is invalid

404

PY0009

Payment does not exist.

400

PY0015

Payment processor server unreachable / timed out.

400

PY0016

Payment processor service error.

PY0019

Forbidden

Your account does not have access to the API. Please contact Fulfillment Team or your Account Manager

400

PY0021

Failed to add customer.

404

PY0023

Customer does not exist.

400

PY0024

Failed to delete customer.

400

PY0025

Failed to update customer details.

400

PY0026

Failed to update card details.

404

PY0027

Card does not exist.

400

PY0028

Failed to delete card.

400

PY0029

No card found for customer.

400

PY0030

Invalid card token status.

400

PY0036

Card is not supported.

400

PY0037

Currency is not supported.

404

PY0038

Webhook does not exist.

400

PY0039

Webhook already exists.

400

PY0042

Charging of subscription is not applicable.

400

PY0043

Card already exists.

400

PY0045

Payment is not available for void.

400

PY0044

Payment is invalid.

404

PY0046

Refund does not exist.

401

PY0047

Payment is ineligible for refund.

400

PY0048

Requested refund amount is greater than the original amount.

404

PY0049

Subscription does not exist.

400

PY0051

Failed to update subscription details.

400

PY0052

Failed to cancel subscription.

400

PY0053

Merchant already exists.

400

PY0054

Subscription already charged.

422

PY0057

The payment has expired and cannot be processed.

403

PY0058

The merchant indicated does not have P2M services enabled.

QR functionality is not enabled on the account

408

PY0061

Notification server unreachable / timed out.

400

PY0062

Notification service error.

404

PY0063

Void does not exist.

400

PY0064

Invalid JSON Format.

400

PY0065

This merchant has no customizations present.

400

PY0068

Payment not executed due to authorization failure.

400

PY0069

Authentication server unreachable / timed out.

400

PY0070

Scheme is unsupported by merchant

400

PY0071

Payment mismatch with Merchant.

400

PY0072

Transaction cannot be processed. Cannot refund a transaction before cut off time.

400

PY0073

Transaction cannot be processed. Cannot void a transaction after cut off time.

400

PY0082

Refund already exists.

400

PY0085

Payment must be reversed from terminal.

400

PY0088

Card data already provided

400

PY0089

No card data provided

400

PY0090

Buyer data already provided

400

PY0091

Payment state is invalid for sending webhooks

400

PY0092

Merchant’s registered webhook is unreachable

409

PY0093

Payment has already been updated.

400

PY0094

Payment is not available for capture.

400

PY0095

Amount must be less than or equal to amount authorized.

400

PY0096

Amount must be equal to amount authorized.

PY0100

Authentication failed.

PY0101

Acquirer decline due to high risk.

400

PY0102

Card is required, as there is no Fund Source attached to your account.

400

PY0103

Payment is already expired.

400

PY0104

Reference number is linked to multiple payments.

400

PY0105

Account has insufficient balance to perform this transaction.

400

PY0106

Failed to send notification.

400

PY0111

Invalid batch status.

400

PY0112

QR data is not supported.

400

PY0113

Partial refund is not allowed for this transaction.

400

PY0114

WeChat Service unreachable / timed out.

400

PY0115

WeChat Service error.

400

PY0116

Transaction could not be completed.

400

PY0117

Card is invalid.

400

PY0118

Transaction could not be completed with this terminal.

400

PY0119

Issuer declined card or account.

400

PY0120

Issuer decline.

400

PY0121

Card is expired.

400

PY0122

Issuer system is unavailable.

400

PY0123

Account limit exceeded.

400

PY0124

Transaction could not be verified.

400

PY0125

PIN is invalid or incorrect.

400

PY0126

PIN is invalid or incorrect.

400

PY0127

Please update incomplete customer records.


Did this page help you?