CVPay

How to accept GCash payments on your website

Plan GCash acceptance for your website: confirm merchant eligibility, define the PHP pay-in flow, prepare sandbox testing and verify payment status handling.

Accepting GCash on a website starts with confirming that the payment method is available for your business. It then requires a clear collection flow: what the customer does, how your system receives the payment result, and what your team checks before fulfilling an order.

This guide covers that planning and testing work. It is for businesses evaluating GCash pay-ins through CVPay, rather than consumers looking to transfer money or manage a personal wallet.

1. Confirm the scope for your merchant account

CVPay lists GCash among its supported pay-in methods in the Philippines. The methods enabled for a particular merchant account must still be confirmed during onboarding. A method appearing on a provider's website is not a promise that every applicant can immediately use it.

Before building, describe your business, your website, the currencies you need and the collection flow you want to offer. Ask which requirements apply to your account and which documentation your developers should use. Confirm any documents requested through the onboarding process before sending them.

Keep collection and disbursement requirements separate. GCash support for receiving customer payments does not, by itself, establish support for sending payouts to GCash wallets.

2. Define the payment journey before choosing an implementation

Write a short description of your checkout. Include where the customer chooses GCash, how the amount is presented, which system owns the order and what the customer sees while payment is unresolved.

Then ask CVPay to confirm the applicable integration flow. Do not assume that a particular QR format, redirect, hosted page or wallet interaction is available because you have seen it on another service. Your developers need the flow that applies to the account being opened.

Decide what information your support team needs to locate an order without asking the customer for unnecessary personal information. Agree how the storefront and back office will refer to the same purchase. These are design decisions to resolve before testing, not details to improvise after a customer reports a problem.

3. Separate the customer screen from the payment result

A checkout screen needs to explain whether an order is waiting for payment, has a confirmed result or needs further attention. Ask the provider which payment states are authoritative and how your application should interpret them.

CVPay provides signed webhook notifications when payment status changes. Your technical team should obtain the applicable verification instructions and test the notification handling in the agreed integration environment. A signature should be checked according to that documentation; this article does not substitute an example algorithm for the actual specification.

Also agree when your business will fulfil an order. Do not treat a customer returning to your website as proof that a payment is complete. Have the technical and operations teams document which evidence they require before releasing goods, access or services.

4. Prepare a sandbox test plan

CVPay merchant onboarding requires KYB review. A sandbox is opened before production, and the two environments are separate. Use the documentation and access supplied for the applicable environment.

Prepare a test worksheet with a scenario, expected result, actual result, evidence and owner. Ask the integration team which scenarios the sandbox can demonstrate. Useful questions include:

  • Can the team demonstrate the agreed successful payment flow from checkout to order status?
  • What should the application show when a customer has not completed the flow?
  • How should it handle a notification that fails verification?
  • What should happen if a status notification is received more than once?
  • How will staff investigate an order whose status is still unresolved?

These are acceptance questions. They do not assert that the sandbox simulates every possible event or that CVPay implements a particular retry policy. Record the agreed answers and any remaining limitations.

5. Confirm commercial and operational conditions

Request the applicable fees, limits and operational conditions before deciding whether the solution fits your business. Do not assume a fee, confirmation time or settlement schedule from a generic description of GCash.

Ask your team to distinguish a customer completing payment, a payment status being reported and money reaching a destination account. When discussing timing, specify the event you mean. This prevents a promise about one stage from being interpreted as a promise about another.

Assign an owner for unresolved orders and agree which information to provide when requesting assistance. Keep credentials and customer data out of ordinary support messages unless the provider has explicitly requested the information through an appropriate channel.

6. Review the launch decision as a team

Before requesting production use, have business, engineering and operations review the same checklist. Confirm the approved payment method, current documentation, tested status handling and responsibilities for support. Check that the website describes only the flow your account can actually offer.

After launch, measure the steps separately: checkout visits, payment attempts, confirmed payment outcomes and fulfilled orders. A click on a GCash button is not a completed payment, and a completed payment is not automatically a new customer. Use the definitions agreed for your implementation.

Where CVPay fits

CVPay supports PHP, VND and USDT pay-ins and pay-outs through one merchant account and one API. For Philippine collections, the published pay-in methods include GCash, Maya, GrabPay and QR Ph, subject to confirmation for the merchant account. This guide focuses on GCash collection, not wallet payouts.

Read the Philippines payments overview, review pay-in information and use the developer entry point to prepare your integration discussion.

Ready to check suitability? Start KYB registration or contact CVPay with your website, target market and proposed collection flow. Confirm account eligibility and the applicable integration plan before building your checkout.