Skip to main content

Introduction

Maya uses a redirect-based payment flow. When a customer selects Maya at checkout, they are redirected to Maya’s app or web interface to authenticate and confirm their payment, then redirected back to your website or app upon completion. Maya is a single-use payment method where customers must authenticate each payment. This guide explains the process of integrating Maya into your app or website using Payrails.

Pre-requisites

Before you start accepting Maya payments with Payrails, there are a few requirements you must meet:

Ways to integrate Maya

Payrails SDK

Server-to-server integration

Parse Maya from lookup response

Pass Maya payment method in request to authorize payment with Payrails

Note on amountsPHP uses 2 decimal places. Amounts should be provided in the smallest currency unit—for example, 50000 for ₱500.00.
Maya is a redirect-based, single-use payment method. After calling the authorize endpoint, the customer will be redirected to Maya’s app or web interface to authenticate and confirm the payment. Once confirmed, the customer will be redirected back to the returnInfo.success URL. Make sure to provide valid returnInfo URLs in your authorization request.

Handle the redirect response

Supported currencies

Maya via dLocal supports the following presentment currency:
  • PHP — Philippine Peso

Supported regions / countries

Customer regions

Maya is available to customers based in:
  • Philippines 🇵🇭

Merchant regions

Merchants enabled for the Philippines can accept Maya payments via dLocal.

Supported workflows and services

Last modified on September 28, 2026