GCash Link & Pay

GCash is a mobile wallet and online payment service in the Philippines. It is a versatile financial service platform that has become an integral part of the country's financial ecosystem. GCash allows users to perform a wide range of financial transactions using their smartphones. With a penetration rate of about 80% of the Philippine population, GCash is continuously growing.
It is a more accessible digital payment option compared to credit cards, as anyone with a mobile phone can use GCash. Users only need to provide their phone number to begin transactions with GCash, eliminating the need for lengthy account numbers used by cards. Having GCash available as a payment method in the Philippines is recognised as one of the easiest ways to boost collection rates.
Please refer to the payment method collection guide to learn more about managing linking errors with GCash when creating a payment method token.
What You Need to Know
- Merchant Paid Fees only - GCash strictly prohibits passing transaction fees to end users. As a result, only merchant-paid fees are supported. Any implementation that attempts to surcharge or transfer fees to the customer is non-compliant.
- No Multi-Linking for same merchant group - A GCash wallet can only be linked once per merchant group. If a customer has already linked GCash at one location under the same merchant group (e.g., Gym Brand A – Location A), they cannot link or use GCash at another location within the same group (e.g., Gym Brand A – Location B). Attempts to do so will fail with the error:
PAYMENT_METHOD_ALREADY_EXISTS. - Unlink via GCash App - Customers can unlink their GCash wallet at any time directly from the GCash app. Once unlinked, the existing GCash token becomes invalid. Any subsequent invoice or charge attempt using that token will result in the invoice being marked past due and return the
error: invalid_payment_method. - No refunds - At the time of writing, GCash does not support refunds on payments done with GCash Link & Pay
GCash linking failure
| GCash Failure response | Ezypay Error Message |
|---|---|
| API_VALIDATION_ERROR | GCASH - api_validation_error - System Error - Payment Method Token cannot be created |
| ACCOUNT_ACCESS_BLOCKED | GCASH - account_access_blocked - The account or card has been blocked. Please contact your bank or eWallet provider. |
| CUSTOMER_NOT_FOUND_ERROR | GCASH - customer_not_found_error - System Error - Payment Method Token cannot be created |
| INVALID_ACCOUNT_DETAILS | GCASH - invalid_account_details - Request rejected due to invalid details provided. Please check the details. You may try again. |
| VA_NUMBER_OUT_OF_RANGE | GCASH - va_number_out_of_range - System Error - Payment Method Token cannot be created |
| INVALID_API_KEY | GCASH - invalid_api_key - System Error - Payment Method Token cannot be created |
| CHANNEL_NOT_ACTIVATED | GCASH - channel_not_activated - System Error - Payment Method Token cannot be created |
| FEATURE_NOT_ACTIVATED | GCASH - feature_not_activated - System Error - Payment Method Token cannot be created |
| FEATURE_NOT_SUPPORTED | GCASH - feature_not_supported - System Error - Payment Method Token cannot be created |
| REQUEST_FORBIDDEN_ERROR | GCASH - request_forbidden_error - System Error - Payment Method Token cannot be created |
| DUPLICATE_ERROR | GCASH - duplicate_error - Your account has already been linked to the merchant. Please contact Ezypay or the merchant if you need further assistance. |
| IDEMPOTENCY_ERROR | GCASH - idempotency_error - System Error - Payment Method Token cannot be created |
| SERVER_ERROR | GCASH - server_error - Server Error - Payment Method Token cannot be created |
| CHANNEL_UNAVAILABLE | GCASH - channel_unavailable - The eWallet provider is experiencing unexpected issues - Payment Method Token cannot be created |
| OTP_DELIVERY_ERROR | GCASH - otp_delivery_error - Your eWallet provider has failed to send the OTP to you. Please try again later. |
| PAYMENT_METHOD_ALREADY_EXISTS | GCASH - payment_method_already_exists - Your account has already been linked to the merchant. Please try a different payment type to proceed. Alternatively, please contact the merchant if you need further assistance. |
Updated 3 days ago