← All guides YixingYixing · Business Landing
Settle In · Payment Integration

GCash Payment Integration in the Philippines: Who Does What Between Merchant, Tech Team, and Provider

Updated 2026-09-29·6 min read·Settle In

The most common misunderstanding around GCash payment integration isn't that the tech is too hard — it's that nobody agreed on who does what. The merchant assumes the provider handles everything once the contract is signed; the tech team assumes the provider will build more than just the API docs; the provider assumes the merchant's team already knows how sandbox testing works. This piece breaks it down by role: what the merchant needs to prepare, what the tech team needs to integrate, and what the payment provider is actually responsible for.

Three Roles, Three Responsibilities

GCash payment integration looks like a technical project, but it actually involves three separate parties: the merchant paying for the service, the merchant's own tech team (or contracted developers), and the licensed payment provider. Projects in this space usually stall not because the technology is hard, but because each side assumes the other has it covered. Our Philippines payment gateway overview covers the full integration picture; this article focuses on one specific question — who does what.

Some background first. GCash has over 90 million registered users in the Philippines, and together with Maya the two wallets cover most of the country's active digital users (see our piece on what GCash is). QR payments now account for more than half of all digital transaction volume. QRPH (QR Ph) is the central bank's (BSP) unified national QR standard, not something any single wallet owns — a merchant displays one QRPH code, and GCash, Maya, and dozens of participating banks' apps can all scan it. The standard runs on the internationally common EMVCo QR framework, the same logic behind Singapore's SGQR and Thailand's PromptPay.

An entity that processes payments or fund transfer solutions is classified by the central bank as an Operator of Payment Systems (OPS); issuing e-wallet balances itself requires Electronic Money Issuer (EMI) status. Both licenses are approved by the BSP. Merchants don't need to, and shouldn't try to, apply for either one themselves — that responsibility sits with the licensed payment provider from the start, not the merchant or its tech team.

What the Merchant Needs to Prepare

On the merchant's side, the work is mostly not technical — it's getting the company and its paperwork in order. First, the corporate entity has to be set up before anything else. When a payment provider runs due diligence to satisfy the central bank's KYC/AML requirements, it will ask for registration documents, director information, and a business address. If the entity isn't registered in the Philippines yet, this step simply can't move forward. Sellers doing cross-border e-commerce into the Philippines often trip up here, assuming they can negotiate payment integration first and register the company later — the order is actually reversed.

Second, the merchant and its tech team need to jointly decide on the integration model and activation method — this is not a decision the payment provider makes unilaterally. There are two common integration models: redirecting to a third-party checkout page (the user briefly leaves the merchant's own site or app), or native direct connect (the user stays on the merchant's own page to scan a code or launch the app with one tap — smoother experience, but higher technical demands). There are also three common activation methods: web-based H5 activation for merchants without their own app, in-app SDK integration for merchants with a native app that requires their mobile team's involvement, and offline static or dynamic QR codes suited to storefronts and high-frequency, low-ticket scenarios like chain retail and restaurants. Merchants should decide which category they fall into before integration starts, or requirements will keep shifting mid-project and slow everything down.

Finally, merchants need a corporate bank account ready to receive settled funds. Without one, integration can be technically complete and the merchant still can't actually collect payments.

What the Tech Team Needs to Integrate

The tech team's job is to turn what the payment provider gives it into something that actually runs inside the merchant's own business systems. The general framework: after submitting company documents for due diligence, the payment provider assigns a sandbox testing environment, and the tech team integrates order creation, payment callbacks, and refunds there; once integration testing passes, there's a pre-launch review covering transaction reconciliation accuracy, payment success rates, and whether risk-alert mechanisms trigger properly; only after that does the merchant move to the production environment and go live.

During sandbox integration, there are details the tech team needs to actively ask about rather than discover after something breaks: whether payment results are retrieved by actively polling or pushed via a webhook callback, since the two require different system architecture; whether the API is idempotent, so the same payment notification sent twice doesn't create a duplicate transaction record; and whether refunds go back through the original payment channel or as a separate transfer, and whether the funds land on the same timeline as the original payment. None of this is something the payment provider can fully anticipate on the tech team's behalf — the tech team has to confirm it during integration.

Once live, the tech team's job isn't done either. Ongoing reconciliation and anomaly monitoring through the merchant dashboard's transaction reports is a long-term operational task, not something that ends on launch day.

What the Payment Provider Does, and Doesn't Do

The payment provider's core job is holding and maintaining regulatory compliance — both the OPS and EMI licenses require BSP approval, typically on a quarterly rather than weekly timeline — and providing technical documentation, sandbox environments, settlement channels, and transaction-level risk controls. Settlement speed usually comes in two flavors: D0 (same-day settlement) and T1 (next-day settlement). Not every provider does D0 across the board, so merchants should ask exactly which applies and whether there are exceptions.

What the provider doesn't do matters just as much, and this is where most misunderstandings happen: the merchant's own KYC/AML documentation is still the merchant's responsibility to produce, the provider won't supply it on the merchant's behalf; the merchant's own app integration work and web development still require the merchant's tech team to put in the hours, with the provider offering an SDK and docs at most; and decisions like redirect versus native direct connect, or H5 versus SDK versus offline QR, are business calls the merchant has to make, with the provider advising rather than deciding.

Verifying whether a provider is actually licensed is also the merchant's own homework. Not every entity that claims to do payment integration actually holds a BSP OPS or EMI license — subcontracting and unlicensed pass-through arrangements aren't uncommon. The central bank publishes a registry of licensed Electronic Money Issuers and Operators of Payment Systems, which can be checked against a provider's claimed license number and registered company name. One licensed provider we're aware of is SmartPay (paysmartph.com), which handles native GCash direct-connect, QRPH aggregated collection, and Maya disbursement, and holds both BSP OPS and EMI status. Merchants can verify this themselves and compare a few providers before committing — contact details are usually public on the provider's own site, or via Telegram (@LouisSMARTPAY).

The Less Convenient Truths

A few things worth knowing upfront:

  • Working with a licensed provider doesn't mean the merchant can step back entirely — whatever KYC/AML documentation is the merchant's own to produce, the merchant still has to produce it.
  • Fee structures, settlement cycles (D0 vs. T1), and the number of supported channels vary by provider — it's worth comparing more than one before signing.
  • GCash and QRPH systems get their APIs and rules updated periodically. Integration isn't a one-time task, and the tech team needs to keep tracking changes after launch.
  • Newly registered companies can take longer to clear due diligence than established ones, simply because there's less operating history to check — worth building extra time into the schedule.

Official Sources

References to the QRPH standard and OPS/EMI licensing in this article come from central bank public information; check current official guidance for specifics.

If the merchant is still working on setting up its corporate entity, our company registration service can help get the registration documents and director information ready that a payment provider will ask for during due diligence.

About this guide and Yixing

Want someone to check your documents against the current requirements? → Yixing can review your case with you

Yixing is a private consulting company registered in the Philippines (SEC Reg. No. CS202009551; BI Accreditation No. CA-202624381-1). This guide does not name or rate other providers and does not promise any outcome; approval rests with the competent authority, and the rules in force are those it currently publishes. For legal disputes or case-specific judgments, consult a practising lawyer — this is not legal advice.

Frequently Asked Questions

How long does GCash payment integration usually take to go live?
It depends on how prepared the merchant is, whether company documents are complete, and how quickly the tech team clears sandbox integration. Central bank licensing timelines typically run on a quarterly rather than weekly basis, so there's no fixed schedule — plan ahead rather than starting preparation right before launch.
Will the payment provider also handle company registration for the merchant?
No. The corporate entity needs to be set up first — when a provider runs due diligence, it asks for already-registered documents, director information, and a business address. That's the merchant's own task, separate from payment integration, and it has to come first.
If the merchant has no in-house tech team, can the payment provider just do the whole integration?
The provider supplies the API, documentation, and sandbox environment, but actually wiring order creation, callbacks, and refunds into the merchant's own systems still takes the merchant's tech team or contracted developers. That workload should be scoped in advance, not assumed to be included.
Should the merchant choose webhook callbacks or active polling?
The two approaches place different demands on system architecture, and neither is universally better — it depends on the merchant's own systems and team habits. This is worth confirming directly with the payment provider during sandbox testing, not discovering after launch.
How can a merchant verify whether a provider claiming to do GCash payment integration is actually licensed?
The central bank publishes a registry of licensed Electronic Money Issuers and Operators of Payment Systems, which can be checked against the provider's claimed license number and registered company name — don't rely on a verbal pitch alone.
Can a merchant choose between D0 same-day and T1 next-day settlement?
Not every provider offers D0 across the board. Which one applies, and whether there are exceptions, is worth asking before integration — and worth comparing across providers.
Share this guideFacebookXTelegramViberLINEWeiboLinkedIn

Let’s talk through your situation — free

Every company is different. Leave your details and a Chinese-speaking advisor will get back within 1 business day with practical, industry-specific guidance and a transparent quote.

Get help with Settle In → Free consultation