Digital Wallet Options
These digital wallet options can be combined with any other primary gateway being used on a fundraising page.
- Apple Pay through Stripe
- Google Pay through Stripe
- PayPal One Touch through PayPal
Adding the Digital Wallet Options in Your Account
- Go to your Account Settings.
- Select ‘Gateways‘ to view payment gateway settings.
- Click the ‘New Payment Gateway‘ button.
- Add the relevant digital wallet gateway.
- If adding Stripe Apple Pay or Google Pay:
- You will need to connect to a new Stripe Account using OAuth for Stripe Connect.
- Be sure to check ‘Enable 3D’ secure in order for the wallets to work properly.
- If using a pre-existing Stripe account as the primary gateway, this will continue to process on existing pages, but a new account via Stripe Connect will be necessary to utilize the digital wallets.
- Stripe digital wallet payment currencies must match, and if using multiple currencies need to be added individually.
- If adding PayPal One Touch:
- PayPal One Touch will also need to be added as a distinct gateway option, regardless of an existing PayPal gateway option already exists. PayPal Giving Fund will work in the same way as linking a standard PayPal gateway account. PayPal One Touch cannot be the primary gateway for a page.
- PayPal One Touch can be enabled to accept ANY currencies and does not need to be added individually.
- If adding Stripe Apple Pay or Google Pay:
5. Ensure settings are updated directly in your gateway. In Stripe, add the relevant domains under Settings -> Payment Methods.
Enabling Digital Wallets on a Fundraising Page
To enable digital wallet options that have been added to your account:
- Open the specific fundraising page settings and select ‘Donation settings.’
- Add the desired digital wallet options, and Save your updates.
- Add or update a form block and select ‘Enable digital wallet buttons.’
- Click on the gear icon next to the ‘Enable digital wallet buttons’ option to customize the styling through pre-determined options. Click ‘Save’ when complete. Note you may also adjust the div containers width through CSS.
Rendering Digital Wallets
Digital wallet options will dynamically display on the relevant device and browser (including desktop and mobile), based on the user’s enabling of the specific digital wallet option on their device.
Digital wallet options will only display for one-time transactions and will dynamically hide when the user selects to make a monthly payment.
When a user selects to pay via a digital wallet option and confirms details, the digital wallet will automatically pass back supporter details and skip the unnecessary page(s) requesting contact information to go directly to the confirmation page. New supporters captured will be created with first and last name and email address, along with the transaction details.
Testing Digital Wallets
Apple Pay and Google Pay through Stripe
You can register for a Stripe developer account here: https://dashboard.stripe.com/register
Go to Settings > Payments > Payment methods > Apple Pay and then Configure. Add the domain that your donation page will run under. Don’t worry about step 2 or 3; EN already has the certificate.
- For Apple Pay testing, you can’t add a ‘test card’ but Stripe will see that the gateway is in test mode and will not charge. So it needs to be a working Apple Pay device to test.
- For Google Pay testing, you can add one of the test cards into the Chrome browser, under Preferences > Payment methods.
Apple Pay will display on the page when all of the following apply:
- Apple Pay is turned on for Checkout in your Stripe Dashboard
- The supporter’s device is running macOS 10.14.1+ or iOS 12.1+
- The supporter is using the Safari browser
- The supporter has a valid card registered with Apple Pay
Google Pay will display on the page when all of the following apply:
- Google Pay is turned on for Checkout in your Stripe Dashboard
- The supporter is using Google Chrome or Safari
- The supporter has a valid card registered with Google Pay
PayPal One Touch
You can register for a PayPal developer account here: https://developer.paypal.com/developer/accounts/
- For PayPal ‘One Touch’ testing, you will need to create a REST App
Note that PayPal One Touch is its own gateway type in Engaging Networks. For Stripe, you will need to use the new ‘Connect’ feature in Engaging Networks to add the gateway.
Both Stripe and PayPal gateways can be added to your Engaging Networks account in test mode.
Validation and Processing
Stripe requires Currency to be passed along with the donation and would need to be included in the form.
When processing occurs, we get First Name, Last Name and Email Address back from the gateway (and only this information).
If a supporter comes from an email, Engaging Networks knows the supporter and will attach the transaction against that email address.
If a supporter is not known to Engaging Networks (i.e. direct or not from an email), we will store the First Name, Last Name and Email Address on the supporter’s record.
Its design is to use what we know, prior to processing.
For example :
Page 1 : Donation Amounts
Page 2: Opt In / Address Details
Page 3: Credit Card fields
Page 4 : Thank You
If the digital wallet buttons are on Page 1, then Amount and three supporter fields (returned from the gateway) will be captured.
If the digital wallet buttons are on Page 2, then Amount and whatever has been filled in, will be captured, and so on.
The page logic is that once a digital payment is successful, to go to the last page. In the example above, if on Page 1, then after processing Page 4 will be shown.