GCash API integration
Boldrails is a licensed payment-gateway provider that delivers GCash collections and payouts through one API. Because GCash has no public direct merchant API, businesses accept GCash through a licensed gateway. We acquire and settle GCash payments in PHP or crypto, in one integration that also covers Maya, QR Ph, cards, InstaPay and PESONet. Onboarding typically takes 3 to 5 business days.
- Collections and payouts
- Settle in PHP or crypto
- One multi-rail integration
- Built for high-risk merchants
Last updated: 28 June 2026
Overview
What is the GCash API?
GCash is the largest e-wallet in the Philippines, but it does not publish a direct merchant API you can sign up for and call. The GCash API Portal is partner-only: access runs through GCash's enterprise partnerships and licensed payment gateways. So the practical way to accept GCash is to integrate a gateway that already holds the GCash acquiring relationship.
Boldrails is that licensed gateway. We acquire and settle GCash payments directly, so you integrate once with us instead of chasing a partner slot. You collect and pay out in PHP through our API, and we handle the checkout, webhooks and reconciliation underneath. Payment systems and e-money in the Philippines are regulated by the Bangko Sentral ng Pilipinas (BSP).
Payment flows
How GCash money moves: collections and payouts
One integration covers both directions of money. You collect from customers who pay with GCash, and you send funds out to GCash wallets. Here is how the core flows split by direction:
| Flow | Direction | What it does |
|---|---|---|
| Collections (online) | You request, customer pays | One payment-request call returns a hosted checkout or GCash redirect; the customer approves in the GCash app and you confirm by webhook. |
| In-person QR | Customer scans | Show a QR Ph code at the counter; the customer scans and pays from GCash, settling to the same account as your online sales. |
| Payouts / disbursement | You pay out | Send funds to GCash wallets one by one or as mass batches: payroll, refunds, supplier and commission payments. |
Boldrails exposes all of this through one API and one set of credentials. Collections and payouts run through the same integration, and we settle to you in PHP or crypto, typically the next business day (T+1).
Integration
How to integrate the GCash API
For developers, accepting GCash through a licensed gateway takes six steps. With Boldrails you call one endpoint and we manage the rest.
- 1
Get approved and complete KYB
Apply and submit your business documents (DTI or SEC registration and BIR Form 2303). You need an approved merchant account before you can go live.
- 2
Generate your API keys
Get your live and test API keys from the dashboard. Keep test and live keys separate so sandbox traffic never touches real money.
- 3
Create a payment request
Call the payment-request endpoint with the amount in PHP and the method set to GCash. The API returns a hosted checkout URL or an embedded QR for the customer.
- 4
Register and verify a webhook
Point a webhook endpoint at your server to receive the payment result, and verify each signature (for example HMAC-SHA256). Never rely on polling in production.
- 5
Test in the sandbox
Run pay-ins and payouts end to end with your test keys before switching anything to live.
- 6
Go live
Switch your keys and base URL to production, or let Boldrails manage tokens, callbacks, retries and reconciliation across GCash and every other rail.
One Boldrails integration replaces the work above and adds payouts, settlement and the rest of the Philippine payment stack. You don't build a separate connection per rail.
Comparison
Boldrails vs the partner-only GCash portal
The GCash API Portal is partner-only, so most businesses cannot integrate GCash directly. A licensed payment gateway gives you the access, and a managed layer takes the wiring, retries and reconciliation off your team.
Philippine gateways such as PayMongo, HitPay and Xendit all resell GCash acceptance honestly and well, but they are general-merchant and single-market, and they settle in PHP only. Boldrails adds high-risk acceptance, mass payouts, and settlement in fiat or crypto, on one integration that also reaches other emerging markets.
| Capability | GCash API Portal | Typical PH gateway | Boldrails |
|---|---|---|---|
| Direct access | Partner-only | Resold | Licensed, direct |
| Setup | Enterprise partnership | Hours to days | 3 to 5 days |
| Collections + payouts | Partner-dependent | Collections-led | Both, one API |
| Mass payouts | n/a | Limited | Single + batch |
| Settlement | PHP | PHP | PHP or crypto |
| Other PH rails | GCash only | Most rails | GCash, Maya, QR Ph, cards, InstaPay, PESONet |
| High-risk acceptance | n/a | General merchant | Forex, crypto, PAGCOR-licensed iGaming |
Coverage and settlement
GCash plus the rest of the Philippine stack
You collect and pay out in PHP through GCash, and Boldrails settles to you in fiat or crypto, your choice, typically the next business day. The same integration that accepts GCash also covers the rest of the BSP National Retail Payment System, so you integrate once and turn rails on as you need them. QR Ph, InstaPay and PESONet are BSP rails; Maya is the other major e-wallet.
| Method | Type | Use case |
|---|---|---|
| GCash | E-wallet | Largest PH wallet, online and in-person |
| Maya | E-wallet | Second major Philippine wallet |
| QR Ph | QR standard | Interoperable BSP QR, in-person and online |
| Cards (Visa/Mastercard) | Card | Local and international cards |
| InstaPay | Real-time transfer | Instant bank credit |
| PESONet | Batch transfer | Same-day bank batches |
| GrabPay / ShopeePay | E-wallet | Additional wallets |
| BNPL (BillEase, SPayLater) | Buy now, pay later | Installment checkout |
| Over-the-counter | Cash | Non-bank cash payers |

Pricing
How much does the GCash API cost?
There is no API subscription to accept GCash through a gateway; you pay a processing fee per transaction. GCash collection rates sit around 2 to 2.5 percent across the Philippine market. Boldrails uses custom, volume-based pricing for high-risk and high-volume merchants.
| Method | Typical PH market rate |
|---|---|
| GCash | Around 2.0 to 2.5% |
| Maya | Around 1.8% |
| QR Ph | Around 1.4% |
| Cards (Visa/Mastercard) | Around 3.2% + PHP 10 |
| GrabPay / ShopeePay | Around 2.0% |
| Boldrails | Custom, by volume and risk |
The rates above are publicly observed Philippine market bands, not Boldrails quotes. Our quote includes fiat-or-crypto settlement and multi-rail routing across GCash, Maya, QR Ph, cards, InstaPay and PESONet. Request exact pricing through the Get started form.
Who it's for
Built for high-risk and high-volume merchants
Boldrails is built for high-risk and high-volume merchants in the Philippines and beyond. We accept:
- E-commerce stores and marketplaces
- Licensed forex and CFD brokers
- Crypto exchanges and wallets
- PAGCOR-licensed iGaming operators
- Subscription and SaaS businesses
- Remittance and payout businesses
Accept GCash through one API
Connect GCash collections and payouts through one Boldrails API, settle in PHP or crypto, and add Maya, QR Ph, cards, InstaPay and PESONet without a second build. Onboarding typically takes 3 to 5 business days.
FAQ
GCash API questions
Last updated: 28 June 2026