Wallets
Hyperswitch supports leading international wallets which include:
- Digital wallets such as Paypal which enable customers to pay through wallet balance that they could load
- Card container wallets such as Google Pay and Apple Pay which enable customers to save their cards for quick one-click payments in supported websites
Paypal
Paypal is a digital wallet that lets customers load balance onto the wallet and as well as save their cards for quicker one-touch checkout. Paypal currently supports 200+ countries and 25 currencies.
How to configure Paypal on Hyperswitch?
Since Paypal is both a payment method (wallet) as well as a payment processor, Hyperswitch gives you the flexibility to configure Paypal through multiple avenues.
Paypal native SDK experience:
- Before testing the PayPal SDK integration, ensure that you have enabled PayPal on your Braintree account. Go to https://sandbox.braintreegateway.com/.
- Select the settings icon on the top right.
- Select Processing and enable the PayPal option.
Currently, Hyperswitch supports Braintree’s Vault flow for Paypal as it offers seamless storing of payment methods for later use across Web, iOS and Android devices. The returning customers will be able to pay through Paypal with one-touch experience without logging in again after saving their card the first time.
Paypal Redirection experience:
- Configuring Paypal through other payment processors like Adyen, Checkout, etc on Hyperswitch will redirect the customers to Paypal’s website to complete the payment. For this approach, you just have to make sure that you enable Paypal on your respective processors’ dashboards and also, enable Paypal while configuring these processors on your Hyperswitch dashboard.
Google Pay
Google Pay is a simple and secure way for customers to pay by adding their cards and bank account to their Google wallet. Currently, Google Pay is available through Web and Android devices in 70+ countries while iOS devices are supported only in the US and India.
Google Pay has additional layers of security embedded in its payment flow and hence Google Pay integration is bound to be elaborate by nature.
Prerequisites
There are few prerequisites that need to be fulfilled before integrating Google Pay on Hyperswitch -
- Configure Google Pay on your processor’s dashboard
- In order to test Google Pay integration you will need to add test cards to your google account. You can go to Google Pay API Test Cards Allowlist and click on Join Group to automatically add test cards in your Google Developer Account
Configuring Google Pay on Hyperswitch
To configure Google Pay on Hyperswitch follow the steps given below -
- Login to Hyperswitch dashboard
- In the Connectors tab, select your processor
- While selecting Payment Methods, click on Google Pay in the Wallet section
- Use this link to search for your processor’s input parameters. Get those parameters from the processor dashboard and configure them in Google Pay Merchant Key
- In Google Pay Merchant Name, provide a user-visible merchant name
Go-Live Checklist
Your app requires an approval from Google Pay before you go live. Please follow Google’s instructions and request production access.
- Choose integration type Gateway when prompted.
- Submit your app screenshots for review.
- Set the Google Pay Environment to Production.
- Once the app is reviewed and approved, launch GooglePay from a signed, released build your app.
Google Pay Compatibility
Google Pay is available only in certain countries or regions and on certain devices. Take a look at the exhaustive list of countries where Google Pay is available. For security reasons, Google Pay is not supported in some browsers. Please check the list below to know the supported browsers:
| Browser | Google Pay Support |
|---|---|
Firefox | Yes |
Chrome | Yes |
Safari | Yes |
Opera | Yes |
Mobile-web: Firefox | Yes |
Mobile-web: Chrome | Yes |
Mobile-web: Safari | Yes |
iOS in-app browser - Instagram | No |
Android in-app browser - Instagram | No |
iOS in-app browser - X (Formerly Twitter) | Yes |
Android in-app browser - X (Formerly Twitter) | Yes |
Apple Pay
Apple Pay allows customers to securely pay from their saved cards in their Apple Pay account in macOS (Safari) or iOS using Touch ID and Face ID and thereby eliminating the need for them to manually type in their card and shipping details. Apple Pay is currently supported by participating banks and card issuers in 75+ countries.
Since Apple Pay also boasts additional layers of security, the payments flow and integration for Apple Pay are elaborate too.
Prerequisites
Before beginning to integrate Apple Pay with Hyperswitch, below prerequisites need to be fulfilled. Please feel free to reach out to Hyperswitch support if you are stuck at any stage when integrating and testing Apple Pay.
- Apple Pay requires an Apple Developer Account. You can Sign Up for one here.
- You must have a valid SSL certificate on your domain (meaning it begins with https)
Apple Pay requires additional steps, and requires macOS 10.12.1+ or iOS 10.1+. Follow the steps given below to setting up Apple Pay -
Step 1: Creating an Apple MerchantID
You can create an Apple MerchantID referencing the video or following the steps mentioned below -
- Log in to your Apple Developer account
- Go to the add MerchantIDs section, select Merchant IDs and click Continue
- Add a useful description (like merchant id for test environment)
- Enter a unique descriptive identifier (like merchant.com.testdomain.sandbox) and click Continue
- Verify the description and identifier and click on Register
Step 2: Validating Merchant Domain
You can validate the merchant domain by following the steps mentioned below -
- Log in to your Apple Developer account, go to Identifiers and select the Merchant ID you created previously
- Under the Merchant Domains section, click on Add Domain
- Enter your merchant_domain as domain and click on Save
- Click on Download and a .txt file will be downloaded
- Host this file on merchant_domain/.well-known/apple-developer-merchantid-domain-association.txt
- Once you host the .txt file in the path mentioned above, click on Verify
- Make sure the status is verified as shown in the following image
Step 3: Creating Apple MerchantID Certificate and Private Key
You can create an Apple MerchantID certificate and private key referencing the video below or following the steps mentioned below -
Note: It is recommended that you keep all the generated files in the same workspace for the sake of simplicity
- Open a terminal and create .csr and .key file using the following command -
openssl req -out uploadMe.csr -new -newkey rsa:2048 -nodes -keyout certificate_sandbox.key- Enter your details asked in the prompt and when asked to enter a challenge password, you can leave it as blank. You will get a .csr and .key file
- Log in to your Apple Developer account, go to Identifiers and select the Merchant ID you created previously
- Under the Apple Pay Merchant Identity Certificate section (make sure you are not in the Apple Pay Payment Processing Certificate section), click on Create Certificate
- Upload the .csr file you just created by running the command (it would be called uploadMe.csr if you copy-pasted the command) and click on Continue
- You will get a .cer file on clicking on Download (it will probably be named merchant_id.cer)
- You will need to convert this .cer file into a .pem file using the following command -
openssl x509 -inform der -in merchant_id.cer -out certificate_sandbox.pemStep 4: Creating Apple Pay Payment Processing Certificate
- You will need to get a .csr file from your processor’s dashboard, (like Adyen)
- Upload the .cer file you received while creating Apple MerchantID Certificate on the processor’s dashboard
- Log in to your Apple Developer account, go to Identifiers and select the Merchant ID you created previously
- Under the Apple Pay Payment Processing Certificate section, click on Create Certificate
- After answering whether the Merchant ID will be processed exclusively in China mainland, click on Continue
- Upload the .csr you received from your processor and click Continue
Step 5: Configuring Apple Pay on Hyperswitch
You can configure Apple Pay on Hyperswitch by following the steps mentioned below -
- Login to Hyperswitch dashboard
- In the Connectors tab, select your processor
- While selecting Payment Methods, click on Apple Pay in the Wallet section
- In Apple Merchant Identifier, add your identifier which you added while creating Apple MerchantID
- In Merchant Certificate, copy the text of your .pem file (it will be certificate_sandbox.pem, if you copy-pasted the terminal command), and base64 encode it
- Display Name should be Apple Pay
- In Domain Name, add the verified domain name you configured in Merchant Domains in Apple Developer Account
- In Merchant Private Key, copy the text of your .key file (it will be certificate_sandbox.key, if you copy-pasted the terminal command), and base64 encode it
Note: It is mandatory for you to pass the customer’s billing details for Apple Pay. You can pass these details while creating payment intent as mentioned in the code snippet below -
app.post("/create-payment", async (req, res) => {
try {
const paymentIntent = await hyper.paymentIntents.create({
amount: 100,
currency: "USD",
billing_details: {
address: {
country: "US",
},
},
});
// Send publishable key and PaymentIntent details to client
res.send({
clientSecret: paymentIntent.client_secret,
});
} catch (err) {
return res.status(400).send({
error: {
message: err.message,
},
});
}
});