A new and more secure Stripe Connect V2 integration is now available with more payment options for your customers!
This integration supports Stripe Link, as well as the alternative payment methods GooglePay and ApplePay, in addition to the standard credit card payments. 3D secure is also supported by default. If you are interested in using this gateway, please contact either your Client Success Manager or our Support Team to enable this option in your account.
Setting Up a Provider Profile:
Once this integration has been enabled in your account, to configure your new gateway profile into Sticky.io, you will go to Payments > Gateways, under Actions select Add New Provider Profile. Select Type = Payment/Gateway, Provider = Stripe Connect V2, and fill out the gateway parameters which are outlined below, and Save:
Alias: this is the name that you will assign to your gateway profile; it is for internal purposes only to help you identify the gateway.
Currency: this integration currently supports USD, AUD, BRL, CAD, CNY, EUR, and GBP.
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 Stripe and Sticky:
Once you save your gateway profile within Sticky, you will be redirected to Stripe Connect, where you will need to login to your Stripe terminal and follow the directions to authorize Sticky to send transactions to Stripe on your behalf.
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 for validation. 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 the transaction is verified, the consumer is redirected to the 3Dredirect URL (Thank You) that was provided with the New Order request.
There are certain circumstances where the bank will require 3DS on the rebill transaction. This is outside of Sticky.io's control.
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.
Enabling ApplePay and GooglePay:
Stripe Connect V2 will support subscriptions through both ApplePay and GooglePay, to accept these you’ll first edit your campaign to add them under the Payment Types that you wish to accept. Next, please refer to the Stripe User Guide for directions on adding these Payment Methods to your check out page:
Once you have properly configured Stripe on the frontend, you will need to relay the token from the button output into the new_order call by passing:
creditCardType=applepay
apple_pay_token={token}
OR
creditCardType=googlepay
google_pay_token={token}
Enabling Stripe Link:
Stripe Link will appear as another payment type under your campaign configuration, once you select this payment type you will then select the Stripe gateway profile for it.
With this payment method you will follow the next steps to process your new orders:
authorize_payment: will create the pending transaction on Stripe and will provide you in return a digitalWalletToken that you’ll use in the next step.
Create a payment intent following Stripe’s documentation here, this will provide you with the payment Intent Id in return, format “pi_123abcd456…” which you will use in your new_order call.
For the new_order call you will pass:
“creditCardType”:”stripe_link”
“tranType”:”Capture”
“transactionId”: this will be populated with the payment intent Id from the previous step (“pi_123abcd456…”).
Your transaction will then be completed.
No need to pass the card number with this new_order request when using Stripe Link since you’ll be just capturing the auth previously done using the authorize_payment call.