GCash

GCash is a digital wallet available to customers in the Philippines.

Overview

Property	Details
Markets (consumer)	`PH`
Consumer currencies	`PHP`, `USD`, `CNY`, `HKD`
Authentication methods	`REDIRECT`
Authentication timeout	10 mins
Minimum payment amount	Subject to channel rules
Maximum payment amount	Subject to channel rules
Payment instrument	`DIGITAL_WALLET`
Recurring payments	Yes
Separate captures	No
Refund	Full · Partial · Multiple
Refund validity	365 days
Disputes	No

Payment Flow

Customer selects GCash at checkout.

Customer is redirected to the GCash payment page to complete authorization.

After payment is completed, the customer is returned to the merchant site.

The merchant receives the payment result from UseePay.

Notes

GCash is available for customers in the Philippines.

The billing address country must be set to PH.

Integration Guide

Create a PaymentIntent

Set billing.address.country to PH when creating the PaymentIntent.

Request example (Java SDK)

Response example — GCash (PHP)

{
    "id": "1012608162326154014",
    "code": "0000",
    "message": "Approved or completed successfully",
    "amount": 1,
    "currency": "PHP",
    "status": "requires_customer_action",
    "description": "T-shirt",
    "confirm": true,
    "orderType": "sale",
    "mode": "payment",
    "sale": true,
    "merchant_no": "500000000007381",
    "app_id": "www.pay.com",
    "create_at": "2026-08-16T15:26:01Z",
    "modify_at": "2026-08-16T15:26:01Z",
    "merchant_order_id": "Pjpo5cKNgR3TvcYmKCaMr",
    "refunded_amount": 0,
    "next_action": {
        "type": "redirect",
        "redirect": {
            "method": "GET",
            "url": null,
            "content_type": null,
            "app_url": "https://psp.ac.gcash.com/page/simulation-wallet/acwallet/alipayconnectcode.html?code=281666040097QW0J8YeXj8YNYs0cyhH0dGLV&pspName=TRUEMONEY&loadMode=2",
            "package_name": "com.iap.linker_portal"
        }
    },
    "return_url": "https://www.yourstore.com",
    "client_secret": "7397b3312dc48e23589988f1bfb6dea1",
    "auto_capture": true,
    "order_id": "1012608162326154014",
    "latest_payment_attempt": "pa_13MKOH7E87400",
    "payment_attempt": {
        "id": "pa_13MKOH7E87400",
        "billing": {
            "address": {
                "country": "PH",
                "city": null,
                "postcode": null,
                "state": null,
                "line1": null,
                "line2": null
            },
            "email": null,
            "name": null,
            "phone": null,
            "date_of_birth": null,
            "first_name": null,
            "last_name": null
        },
        "merchant_no": "500000000007381",
        "app_id": "www.pay.com",
        "create_at": "2026-08-16T15:26:01Z",
        "modify_at": "2026-08-16T15:26:02Z",
        "api_version": null,
        "payment_intent_id": "1012608162326154014",
        "checkout_session_id": null,
        "merchant_order_id": "Pjpo5cKNgR3TvcYmKCaMr",
        "order_id": "1012608162326154014",
        "invoice_id": null,
        "subscription_id": null,
        "customer_id": null,
        "mandate_id": null,
        "payment_method_id": null,
        "payment_method_details": {
            "type": "gcash"
        },
        "return_url": "https://www.yourstore.com"
    },
    "setup_future_usage": false
}

Response example — GCash (USD via DCC)

{
    "id": "1012608191543155291",
    "code": "0000",
    "message": "Approved or completed successfully",
    "amount": 1,
    "currency": "THB",
    "status": "requires_customer_action",
    "description": "T-shirt",
    "confirm": true,
    "orderType": "sale",
    "mode": "payment",
    "sale": true,
    "merchant_no": "500000000007381",
    "app_id": "www.pay.com",
    "create_at": "2026-08-19T07:43:17Z",
    "modify_at": "2026-08-19T07:43:17Z",
    "merchant_order_id": "xA7-B4v0vdMAI5ZmngH8J",
    "refunded_amount": 0,
    "next_action": {
        "type": "redirect",
        "redirect": {
            "method": "GET",
            "url": "https://open-sea-global.gcash.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040098ZCZj0cQfR7QW0VzTlQov3Tbk&loadMode=2",
            "content_type": null,
            "app_url": null,
            "package_name": "com.iap.linker_portal"
        }
    },
    "return_url": "https://www.yourstore.com",
    "client_secret": "df0b71bb3a3b0ddc72cec65590f5bb51",
    "auto_capture": true,
    "order_id": "1012608191543155291",
    "latest_payment_attempt": "pa_13NGBCP2MA800",
    "payment_attempt": {
        "id": "pa_13NGBCP2MA800",
        "billing": {
            "address": {
                "country": "TH",
                "city": null,
                "postcode": null,
                "state": null,
                "line1": null,
                "line2": null
            },
            "email": null,
            "name": null,
            "phone": null,
            "date_of_birth": null,
            "first_name": null,
            "last_name": null
        },
        "merchant_no": "500000000007381",
        "app_id": "www.pay.com",
        "create_at": "2026-08-19T07:43:17Z",
        "modify_at": "2026-08-19T07:43:19Z",
        "api_version": null,
        "payment_intent_id": "1012608191543155291",
        "checkout_session_id": null,
        "merchant_order_id": "xA7-B4v0vdMAI5ZmngH8J",
        "order_id": "1012608191543155291",
        "invoice_id": null,
        "subscription_id": null,
        "customer_id": null,
        "mandate_id": null,
        "payment_method_id": null,
        "payment_method_details": {
            "type": "gcash"
        },
        "return_url": "https://www.yourstore.com"
    },
    "presentment_detail": {
        "country": null,
        "amount": null,
        "currency": "USD"
    },
    "setup_future_usage": false
}

When status is requires_customer_action, redirect the customer using the URL in next_action.redirect:

Use url for PC web and mobile web scenarios.

Use app_url for in-app and mini app scenarios.

Payment Method Options

Use payment_method_options.gcash to specify the client environment when initiating a GCash payment.

For the full parameter reference, value descriptions, client scenario table, and request examples, seeClient and OS Type Options

Overview#

Payment Flow#

Notes#

Integration Guide#