Skip to main content
Maya is a digital wallet used by customers in the Philippines. Customers pay from their Maya account and confirm each payment in the Maya app or on the Maya website. Payrails processes Maya through dLocal as the payment service provider (PSP). Open the dLocal guide below for its setup steps and request examples.

​
How a Maya payment works

Maya is a redirect payment method:
  1. The customer selects Maya at checkout.
  2. Payrails returns a redirect URL from dLocal, and the customer goes to Maya.
  3. The customer logs in and confirms the payment in the Maya app or on the Maya website.
  4. Maya sends the customer back to your returnInfo URL.
  5. Payrails receives the final result from dLocal and updates the payment.
Each payment is single-use: the customer confirms every payment on its own. Payrails captures Maya payments immediately, so a successful payment is final. To return funds, refund the payment.

​
Supported currencies and countries

Maya supports PHP (Philippine peso) as its only presentment currency.

​
Integrate Maya

The dLocal guide covers the PSP-side setup, the Payrails configuration, and the request fields dLocal requires.

dLocal

Maya via dLocal

​
Check PSPs

​
Ways to integrate Maya

  • Payrails SDK: the Web SDK shows Maya when your workflow returns it as a payment option, and redirects the customer to Maya. To control how the redirect opens, listen for the actionRequired event.
  • Payrails API: call lookup payment options, then authorize with maya as the paymentMethodCode. The dLocal guide lists the meta fields dLocal requires.
In both cases, confirm the final result through webhook notifications or the execution status. Don’t treat the customer’s return to your success URL as proof of payment.
Last modified on October 5, 2026