GCash payment gateway: how to accept GCash and Maya payments in the Philippines
Why e-wallets dominate online payments in the Philippines, how a GCash and Maya payment gateway works, QR Ph, costs, risks and a checklist for choosing a provider.
9 min de lectura
Este artículo aún no está disponible en Español. Se muestra en English.
Online payments in the Philippines look very different from Europe or the United States. Cards are used, but the everyday way people pay online is the e-wallet on their phone — and for most Filipinos that means GCash, followed by Maya.
If you sell digital goods, run a gaming or top-up site, operate a trading platform or an online store with customers in the Philippines, this guide explains how e-wallet payments work, how a GCash payment gateway fits into your website, what to watch out for, and how to choose a provider.
Why e-wallets lead in the Philippines
Several things pushed Filipinos to e-wallets rather than cards:
- Many people have no credit card, but almost everyone has a smartphone.
- Cash-in is easy: users top up their wallet at convenience stores, pawnshops, banks or through remittances.
- QR Ph, the national QR standard promoted by Bangko Sentral ng Pilipinas (BSP), lets one QR code be paid from many wallets and banks.
The result: industry reports put GCash at around 90 million or more users, with Maya a clear second at roughly 40–50 million. In e-commerce payments, one 2026 report found GCash the single most used method with about 38% share, Maya around 16% and ShopeePay around 10%. The exact numbers differ by source, but the direction is clear: if you do not accept GCash, you lose a large part of Filipino buyers.
GCash and Maya in one minute
GCash is the Philippines' largest e-wallet, run by Mynt (Globe Fintech Innovations). Users pay merchants by scanning a QR code, by "pay with GCash" redirects, or by sending to a merchant account. It also offers savings, loans and insurance inside the app.
Maya (formerly PayMaya) is the second big wallet, connected to Maya Bank. It works in a similar way: QR payments, online checkout, and a wallet that can be topped up in many places.
Both wallets support QR Ph, so a QR Ph code can often be paid from either app or from a bank app.
How a GCash payment gateway works
Asking customers to send money to your personal GCash number and then sending a screenshot does not scale — and it is exactly how fake-receipt scams happen. A payment gateway connects your website to the wallets and automates everything:
| Step | What happens | Who does it |
|---|---|---|
| 1. Create a payment | Your website requests a payment for the order amount and chosen wallet | Your server, via API |
| 2. Show QR or redirect | The gateway returns a QR code or a link to the wallet's checkout | Gateway → your checkout |
| 3. Customer approves | The customer pays in the GCash or Maya app, often with an OTP or PIN | Customer |
| 4. Confirmation | The wallet confirms the payment to the gateway | Wallet → gateway |
| 5. Webhook | The gateway sends a signed webhook: this order is paid | Gateway → your server |
| 6. Fulfilment | Your system delivers the goods or credits the user's balance | Your server |
| 7. Settlement | Paid funds become available and are withdrawn | Gateway → your account |
The important parts are one payment per order (so it can be matched automatically) and a signed webhook that your server trusts — never a screenshot.
QR vs redirect checkout
- QR payments suit desktop shoppers: they scan the code on screen with their phone.
- Redirect (app-to-app) payments suit mobile shoppers: the checkout opens the wallet app, the customer approves, and returns to your site.
A good gateway offers both, and picks the best one for the device.
Costs to plan for
Fees vary by provider, wallet and volume. Usually you will see:
- A fee per successful payment, as a percentage and sometimes a fixed part.
- Withdrawal or settlement fees when you take money out.
- Conversion costs if you are a foreign business settling in another currency.
Ask whether failed or expired payments cost anything (they should not), whether there is a monthly fee, and how long funds take to become available.
Risks and how to handle them
Fake receipts and edited screenshots. The most common scam: a buyer sends a GCash "receipt" that is edited or belongs to someone else. Deliver only after your gateway confirms the payment.
Wrong amounts. Manual transfers to a wallet number invite wrong amounts. Gateway payments fix the amount per order.
Account-takeover fraud. Fraudsters sometimes pay with stolen wallet accounts. Watch for unusual patterns — many new accounts, many payments in a short time, mismatched names — and keep good records.
Webhook failures. If your server misses the webhook, a paid order can stay unpaid in your system. Choose a gateway that retries webhooks and lets you check a payment's status by API, and make your handler idempotent so a repeated webhook never credits twice.
Wallet limits. Wallets have transaction and monthly limits that depend on the user's verification level. Large orders may fail for unverified users; show a clear message and offer another method.
E-wallet payments for gaming, trading and digital goods
E-wallets fit instant-delivery businesses well:
- Gaming and top-ups: credit balances as soon as the webhook arrives.
- Trading platforms: accept deposits in PHP with a clear record of every payment.
- Digital goods: deliver vouchers, codes and subscriptions immediately.
Because these businesses deliver instantly, a correct integration matters: signature checks, idempotency and a clear status for every payment.
Checklist: choosing a GCash and Maya payment gateway
- GCash and Maya, and ideally QR Ph for other wallets and banks.
- QR and redirect checkout, chosen by device.
- Signed webhooks with retries, and an API to check payment status.
- A sandbox to simulate paid, failed and expired payments.
- Clear fees — nothing on failed payments, no hidden monthly fee.
- Settlement that suits you: local account, foreign account or stablecoins.
- Reports with gross, fee and net for every payment.
- One API for more countries, if the Philippines is one of several markets.
GCash, Maya or QR Ph: which should you offer?
If you can only start with one, start with GCash: it reaches the largest number of Filipino buyers. Adding Maya covers most of the remaining wallet users, especially people who also use Maya Bank. QR Ph is the safety net: a customer whose favourite wallet or bank is not listed can usually still pay a QR Ph code from their own app.
The best setup shows the wallets your customers recognise first and keeps the others one tap away. Watch your own numbers: after a few weeks, the dashboard shows which method your customers actually choose and which one has the highest success rate, so you can put that one first.
A practical rule for mixed audiences: on mobile, put the wallet buttons (GCash, Maya) at the top, because one tap opens the app; on desktop, put the QR code first, because the customer scans it with the phone they already hold.
Step by step: adding it to your website
- Create a merchant account and add your website.
- Create a sandbox API key and keep it on your server only — never in the browser or a mobile app.
- Set your webhook URL and save the webhook secret.
- At checkout, create a payment through the API with the order amount and your own order reference, then show the QR code or open the wallet link.
- Handle the webhook: verify the signature, find the order by your reference, and mark it paid only once even if the webhook arrives twice.
- Show the customer a result page, but treat it as information only — the webhook is the source of truth.
- Test every outcome in the sandbox: paid, failed and expired.
- Switch to a live key and watch the first real payments in the dashboard.
Tips to get more orders actually paid
Many customers reach the payment step and still do not pay. Small changes help:
- Show the wallet logos early, on the product page and in the cart, so customers know they can pay with the wallet they use.
- Keep the amount exact and visible next to the QR code or button, with the merchant name customers will see in their app.
- Use a reasonable expiry time. Too short and customers run out of time while topping up their wallet; too long and stock or prices may change.
- Explain what to do if the wallet balance is too low: top up, then come back to the same payment page.
- Send customers back to a clear result page after they pay in the app, with the order status updating on its own.
- Answer payment questions fast, in the customer's language, through chat or messaging apps.
How PAYWISE handles the Philippines
PAYWISE is an API-first payment platform. Indonesia (QRIS) and crypto payments are live today, and the Philippines (GCash QR and Maya) opens on request. When it opens for your account you keep the same API, webhooks and dashboard — only the currency and the wallets are new.
See the Philippines page to send a request, or ask from your merchant dashboard under Payments → Other countries.
Frequently asked questions
Is GCash the same as QR Ph? No. GCash is an e-wallet; QR Ph is the national QR standard. GCash can pay QR Ph codes, and so can Maya and many bank apps.
Do customers need a credit card to pay with GCash? No. They pay from the balance in their wallet, topped up with cash, a bank transfer or a remittance.
How fast is a GCash payment confirmed? Usually within seconds of the customer approving it in the app.
Can a customer reverse a GCash payment? Wallet payments are not like card chargebacks. Refunds are usually made by the merchant through the gateway. Keep records of every order and delivery.
Can a foreign company accept GCash? Yes, through a payment provider that collects in the Philippines and settles to you. Ask how funds are settled and converted.
Do I need separate integrations for GCash and Maya? Not with a gateway that offers both through one API.
Sources: Unbox — GCash dominates e-commerce payments in 2026, Digital in Asia — GCash vs Maya 2026, Antom — GCash, Bangko Sentral ng Pilipinas — QR Ph. User numbers and shares differ between reports and are indicative. This article is general information, not legal or financial advice.

