Direct Pay with Maya Related Errors

Pay with Maya Errors

This page provides a comprehensive list of potential error codes that may arise while processing payments in a direct Pay with Maya integration only.

`PYBY0001` - Missing/invalid parameters


Error Code and Message	`PYBY0001` - Missing/invalid parameters.
HTTP Code	`400`
Problem	The API call was made with missing or invalid parameters. In most cases, the problem is how API Consumers call the API endpoint. It can be a missing parameter in a required field or cannot be done with your current configuration.
What you should do	The API Consumer must review the API specifications and send the API request with complete specs and correct values.

`PYBY0003` - Merchant not found


Error Code and Message	`PYBY0003` - Merchant not found
HTTP Code	`404`
Problem	There is a problem with the configuration of your merchant account.
What you should do	If the error was encountered in PRODUCTION, contact business.support@maya.ph . If the error was encountered during sandbox integration, create a ticket via Maya Developer Hub Service Desk and provide the following: payment ID and/or request reference number the error code you encountered and its corresponding Maya Developer Hub link (this is to make sure that you have exhausted all your efforts and resources in Maya Developer Hub to solve the error) the log of the API request where you experienced the error

`PYBY0004` - Access not allowed


Error Code and Message	`PYBY0004` - Access not allowed
HTTP Code	`401`
Problem	There is a problem with the configuration of your merchant account.
What you should do	If the error was encountered in PRODUCTION, contact business.support@maya.ph . If the error was encountered during sandbox integration, create a ticket via Maya Developer Hub Service Desk and provide the following: payment ID and/or request reference number the error code you encountered and its corresponding Maya Developer Hub link (this is to make sure that you have exhausted all your efforts and resources in Maya Developer Hub to solve the error) the log of the API request where you experienced the error

`PYBY0006` - Payment Service Error. Please contact your system administrator


Error Code and Message	`PYBY0006` - Payment Service Error. Please contact your system administrator
HTTP Code	`400`
Problem	A problem was encountered between your server and Maya.
What you should do	If the error appears, the API Consumer can retry the operation. If the issue persists, they can reach out to Maya through these channels: If the error was encountered in PRODUCTION, contact business.support@maya.ph . If the error was encountered during sandbox integration, create a ticket via Maya Developer Hub Service Desk and provide the following: payment ID and/or request reference number the error code you encountered and its corresponding Maya Developer Hub link (this is to make sure that you have exhausted all your efforts and resources in Maya Developer Hub to solve the error) the log of the API request where you experienced the error

`PYBY0009` - Wallet does not exist


Error Code and Message	`PYBY0009` - Wallet does not exist
HTTP Code	`404`
Problem	The API call was made with the wrong `linkId`
What you should do	Use a correct `linkId` or generate a new `linkId` using Create Wallet Link

`PYBY0010` - Wallet is inactive or deleted from the system and cannot be used for this transaction


Error Code and Message	`PYBY0010` - Wallet is inactive or deleted from the system and cannot be used for this transaction
HTTP Code	`400`
Problem	The API call was made with the wrong `linkId`
What you should do	Use a correct `linkId` or generate a new `linkId` using Create Wallet Link

`PYBY0012` - A problem is encountered. Please contact your system administrator.


Error Code and Message	`PYBY0012` - A problem is encountered. Please contact your system administrator.
HTTP Code	`400`
Problem	A problem was encountered between your server and Maya.
What you should do	If the error appears, the API Consumer can retry the operation. If the issue persists, they can reach out to Maya through these channels: If the error was encountered in PRODUCTION, contact business.support@maya.ph . If the error was encountered during sandbox integration, create a ticket via Maya Developer Hub Service Desk and provide the following: payment ID and/or request reference number the error code you encountered and its corresponding Maya Developer Hub link (this is to make sure that you have exhausted all your efforts and resources in Maya Developer Hub to solve the error) the log of the API request where you experienced the error

`PYBY0014` - Currency not supported


Error Code and Message	`PYBY0014` - Currency is not supported
HTTP Code	`400`
Problem	The API call was made with the wrong currency.
What you should do	API Consumers are restricted to utilizing only the specified currency within their integration. Ensure to pass the currency value that has been configured.

`PYBY9999` - A problem is encountered. Please contact your system administrator.


Error Code and Message	`PYBY9999` - A problem is encountered. Please contact your system administrator.
HTTP Code	`400`
Problem	A problem was encountered between your server and Maya.
What you should do	If the error appears, the API Consumer can retry the operation. If the issue persists, they can reach out to Maya through these channels: If the error was encountered in PRODUCTION, contact business.support@maya.ph . If the error was encountered during sandbox integration, create a ticket via Maya Developer Hub Service Desk and provide the following: payment ID and/or request reference number the error code you encountered and its corresponding Maya Developer Hub link (this is to make sure that you have exhausted all your efforts and resources in Maya Developer Hub to solve the error) the log of the API request where you experienced the error