Apple Pay and Google Pay
Apple Pay and Google Pay
Both Apple Pay and Google Pay services are part of the Comgate payment gateway. To view customer services, you only need to have the CARD_CZ_COMGATE
or CARD_CZ_CSOB_2
card payment method enabled.
Recurring and verification payment functionality cannot be used within the service. Other functionalities are available.
Displaying services
The display of both Apple Pay and Google Pay services depends on whether the selection of payment methods is in the e-shop cart or the e-shop uses the selection of methods from Comgate. It is also necessary to distinguish whether the payer should be redirected to the card gate or Apple Pay or Google Pay will be displayed directly in the e-shop cart.
We therefore distinguish three possibilities of displaying:
-
The button in the card gateway - If the choice of payment methods is on the Comgate side, no modifications are required to display the services. It is sufficient to have the card payment method
CARD_CZ_COMGATE
orCARD_CZ_CSOB_2
enabled. After the payer has selected one of these methods, the payment is made through the standard process with redirection to the payment gateway, where the services are displayed automatically. Here, the payer is also allowed to manually enter the card number. If the payer reaches the gateway from a device or browser that does not support any of the services, the payer will be able to make at least a payment by credit card. -
The button in the e-shop's cart with the redirection of the payer to the card gateway - If the choice of payment methods is on the side of the e-shop, the payment is based as a regular payment, however, in the request you need to call the
APPLEPAY_REDIRECT
orGOOGLEPAY_REDIRECT
method. Subsequently, the payer is redirected to the payment gateway using the obtained payment link. Both Apple Pay and Google Pay buttons will then appear automatically on the card gateway. Subsequently, the payment process from the payer's point of view is identical to the first option. We recommend that you follow our Google Pay and Apple Pay Button Display Policy, which are available below. -
The button in the e-shop's cart with the redirection of the payer to the card gateway This integration option does not redirect the payer to the card gateway and the payment is completely processed directly in the e-shop environment. Implementation of this behavior is more challenging than both of the above mentioned options. For this purpose, you must use our prepared JavaScript library Checkout SDK. Detailed information on the integration process can be found in Checkout SDK documentation section.
If the merchant does not check the availability of Apple Pay and Google Pay on their side, this method may not be available as a result, even if the payer chose it in the e-shop cart. The payer is then offered a standard payment by card with a copy of the data.
Button display policy
Apple Pay in shopping cart
Apple Pay is only available to users who have a Safari web browser and a custom Apple device that has a Touch ID or Face ID. These devices include MacBook, iPhone, iPad and desktop Mac. For this reason, we recommend that you display the service in your order only to clients who can pay with Apple Pay. Instructions can be found directly at Apple's developer site.
The easiest way to verify this is through:
if (window.ApplePaySession) {
// Apple Pay JS API is available => we are on a supported device
window.ApplePaySession.canMakePayments()
.then((result) => {
// device is able to make payments using Apple Pay
})
}
There are also several requirements required by Apple:
Google Pay in shopping cart
For Google Pay, you need to comply with the requirements required by Google:
Cases when Apple Pay does not appear
It may happen that Apple Pay will not be shown to the payer if the Apple Pay library evaluates that it is not possible to make the payment on the device.
Apple Pay does not appear when:
- payer is in a different browser than Safari (the same applies to “in App” browser on iOS ).
if the payer is in a supported Safari browser, then Apple Pay will not appear when:
- payment is processed in iframe,
- the payer has no card inserted in Apple Wallet,
- the device does not support Apple Pay (for example, non-updated device),
- the Apple Pay library evaluates for some reason that the payment cannot be made (reasons not disclosed),
- Payment Request API is not available in the browser context,
- it is not allowed to use the Apple Pay method on the store (for example for Shopify),
- the store does not use the
CARD_CZ_COMGATE
orCARD_CZ_CSOB_2
method to process card transactions, - it is a recurring payment (established with the
initRecurring=true
parameter), - it is a verification payment (established with the
verification=true
parameter), - it is a repeated initiation payment.,
Cases when Google Pay does not appear
It may happen that Google Pay will not be shown to the payer if the Google Pay library evaluates that it is not possible to make the payment on the device.
Google Pay does not appear when:
- the Google Pay library evaluates for some reason that the payment cannot be made (reasons not disclosed),
- the payment is opened in the internal browser of Facebook or Instagram App, or others,
- Payment Request API is not available in the browser context,
- payer uses unsupported browser (list of supported browsers),
- it is not allowed to use the Apple Pay method on the store (for example for Shopify),
- the store does not use the
CARD_CZ_COMGATE
orCARD_CZ_CSOB_2
method to process card transactions, - it is a recurring payment (established with the
initRecurring=true
parameter), - it is a verification payment (established with the
verification=true
parameter), - it is a repeated initiation payment.,