CREATED: October 25, 2018
UPDATED: October 12, 2021
Stripe Connect offers a more secure and enhanced experience for your customers. Stripe Connect also includes 3D Secure and Capture on Shipment functionality. Sign-up is simple and can be completed within your sticky.io platform.
NOTE: Please be aware that 0.00 initial transactions are not supported when using Stripe gateway. If using Stripe, the initial order MUST have a valid amount.
3D Secure Setup is Automatic
Stripe Connect dynamically uses 3D Secure with every merchant account. You do not need to sign up for it or add it anywhere in the sticky.io setup. Stripe Connect will send any payment that qualifies to 3D Secure. On your frontend website, you need to be able to handle the redirect URL as well as a gateway response. Please make sure that you implement the API 3DS call, found here.
For more information on the 3D Secure redirect URL, please refer to the documentation at https://stripe.com/docs/payments/3d-secure.
Points to be Aware of Regarding 3DS
With Stripe Connect, 3D Secure 2.0 is automatically enabled.
3Dredirect URL (three_d_redirect_url) is essential to be submitted with the New Order request. This will allow the consumer to redirect to the merchant's Thank You page, after the 3D authentication process.
3D Secure is dynamic to each transaction and the processing bank determines if 3D Secure is needed on each transaction.
If 3DS is not needed, the transaction will process and we will return the OrderID and TransID in API response.
If 3DS is needed for the transaction, Stripe will return to us the ACS URL, and you will receive a 101 response code indicating that you need to submit the 3DS call with the order Id in it to finalize the sale.
Once transaction is verified, the consumer is redirected to the 3Dredirect URL (Thank You) that was provided in NewOrder request.
There are certain circumstances where the bank will require 3DS on the rebill transaction. This is outside of sticky.io's control.
For more information on this Gateway, visit https://stripe.com/
Setting Up a Provider Profile
Parameter Descriptions:
Gateway Alias: Name that you will assign to the gateway. This is for internal purposes only. It helps you identify a specific gateway account among several of them in your CRM.
Account ID: There is no need to populate this field as it will automatically be populated once you’ve granted access to your Stripe Connect account.
Post Descriptor: Select "Yes" to send the descriptor to the gateway.
Currency: The Stripe Connect Gateway currently supports USD, AUD, CAD, CHF, DKK, EUR, GBP, INR, JPY, MXN, NGN, NOK, NZD, PEN, SEK, and ZAR currencies.
Test Mode: Set to "Yes" if you would like to use this gateway in Test Mode.
There are 2 Required Fields on the Merchant Account Details tab.
Descriptor - This will be the MID Descriptor
Customer Service Number - The customer service number assigned to the MID
There is 1 Required Field on the Limits and Fees tab
Global Monthly Cap - This will be the sales amount allowed monthly on this MID
To maximize the efficiency of sticky.io Reporting & Analytics, we suggest you take a moment and fill out the rest of the fields. These will all be used in sticky.io’s profitability reports.
For field definitions on all of the fields on the "Merchant Account Details" Tab and the "Limits & Fees" Tab, click here.
Once your gateway profile has been created, you will then go through your campaigns and assign the gateway to the corresponding campaign(s).
Connecting with Stripe
If you do not already have an account with Stripe, you will need to fill out the account activation form. You will need to provide your full business details and your personal information, including the last four of your SSN and your date of birth.
Note: An individual or sole proprietor must activate their own account. If you’re trying to activate this account on behalf of someone else, please invite them to become the account owner and complete the activation themselves.
The final step is to authorize sticky.io access to your Stripe Connect account.
Authorize sticky.io on Your Stripe Connect Account
If you already have a Stripe account, then you just need to login and grant access to sticky.io.
Enabling Apple Pay / Google Pay
The Stripe integration also supports the use of mobile payment types such as Apple Pay and Google Pay.
Subscription transactions are supported with Apple Pay and Google Pay, but your merchant account with Stripe needs to be configured to accept rebills.
Referring to the Stripe website:
"You can start accepting Apple / Google Pay payments on the web using Checkout or Elements. No additional configuration is required to use Apple Pay in Checkout. For Elements, refer to the Payment Request Button documentation provided by Stripe to learn how to add Apple Pay to your site."
You can also find Apple Pay best practices for the integration here. Based on the web browser being used by the customer, the respective Apple Pay / Google Pay button will be shown (depicted below):
Once you have properly configured Stripe on the frontend, you will need to make sure you are passing the appropriate values within the designated parameter in the new_order
call. More information can be found here.
wallet_token
= Token generated by widgetcreditCardType
= ApplePay or GooglePay