Differences
This shows you the differences between two versions of the page.
Previous revisionNext revision | |||
— | gateways:stripe [2020/10/06 09:22] – [Migrating from previous Stripe integrations or other gateways to Stripe] adam | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ---- dataentry gateway ---- | ||
+ | type : gateway # do not change this line | ||
+ | name : Stripe | ||
+ | countries | ||
+ | support-added | ||
+ | support-removed | ||
+ | auth-net-emulation | ||
+ | supports-3dsecure | ||
+ | supports-multicurrency : yes # enter " | ||
+ | gateway_url | ||
+ | ---- | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ====== Stripe ====== | ||
+ | ===== Setting Up Stripe for FoxyCart ===== | ||
+ | - Create your account [[https:// | ||
+ | - Go to the [[https:// | ||
+ | - Once logged in, make sure your store is set to "Live Servers" | ||
+ | - Go to the //Accept payments using your Stripe account// option, check the box, and click the //Connect to Stripe// button. | ||
+ | - Follow the instructions that appear. | ||
+ | - Once returned to the Foxy admin with Stripe successfully connected, enable the //Show Credit Card form// option if it isn't already and save the configuration. This option will show the credit card entry on the Foxy checkout. If you're already using an integration that shows a credit card input on the checkout, you'll need to disable that in order to show the Stripe credit card input. | ||
+ | |||
+ | <WRAP center round important 80%> | ||
+ | Please note that when using the //Stripe// option, you won't be able to have a gateway enabled under the //Let Customers Pay with a Credit or Debit Card// option, since the Stripe option shows a credit card form within the checkout already, and only one is allowed on the checkout at a time. | ||
+ | </ | ||
+ | |||
+ | ==== Adding a custom statement descriptor suffix ==== | ||
+ | |||
+ | As part of the configuration for Stripe in the Foxy admin, it's also possible to specify a statement descriptor suffix, which will be appended to the statement descriptor as set in your Stripe configuration which appears on your customers card statements. | ||
+ | |||
+ | This can be set using the optional " | ||
+ | |||
+ | |||
+ | f | ||
+ | ==== Migrating from previous Stripe integrations or other gateways to Stripe ==== | ||
+ | |||
+ | If your store is currently making use of one of our older Stripe integrations, | ||
+ | |||
+ | - Log in to your store' | ||
+ | * It'll look like this: \\ {{ : | ||
+ | * Note that if you have multiple payment sets that you will be updating to Stripe, we recommend updating them one at a time. | ||
+ | - Leave the "Let customers pay with a Credit or Debit Card" option enabled for now. We'll come back to it later. | ||
+ | - Further down the page, look for the checkbox labelled " | ||
+ | - Click the " | ||
+ | - Once redirected back to the checkout, you should see Stripe enabled, but leave the "show credit card form" unchecked for now. | ||
+ | - <wrap hi>If you have subscriptions, | ||
+ | - <wrap hi>If you don't have saved customers or subscriptions, | ||
+ | - Make sure you're on the " | ||
+ | - Uncheck the checkbox for "Let customers pay with a Credit or Debit Card" at the top of the page. This will disable the older Stripe integration. | ||
+ | - Check the "show credit card form" checkbox within the Stripe Connect options (towards the bottom of the page) to enable the new Stripe integration. | ||
+ | - Save the page. | ||
+ | - Load up your website and simulate a purchase. Make sure your checkout still shows a credit card form. If you'd like, run a test transaction (and then void/refund your order in Stripe). (Don't do this more than once, as testing on a live account should only be done sparingly.) | ||
+ | - OPTIONAL but RECOMMENDED: | ||
+ | |||
+ | At this point, your store has been successfully updated to use our Stripe integration. | ||
+ | |||
+ | <WRAP center round important 90%> | ||
+ | If you have set your checkout template to " | ||
+ | </ | ||
+ | |||
+ | ===== Supported Countries ===== | ||
+ | |||
+ | Stripe is continually expanding the countries that they support. The good news is, FoxyCart' | ||
+ | |||
+ | ===== Overriding the Order ID ===== | ||
+ | As of Foxy v2.0, the "Order ID" that Foxy passes to Stripe (which is normally the Foxy transaction ID) can be overridden. This is considered advanced functionality, | ||
+ | |||
+ | To override the default Foxy transaction ID, add [[https:// | ||
+ | |||
+ | ===== Testing ===== | ||
+ | ==== Obtaining a Test Account ==== | ||
+ | For configuring a test account with Stripe, you can simply complete the same process as detailed above, but leaving your payment servers set to "Test Servers" | ||
+ | ==== Test Card Numbers ==== | ||
+ | You can use 4242424242424242 to simulate successful card validations in test mode (this number fails in production of course). | ||
+ | |||
+ | Technically, | ||
+ | |||
+ | The following are also true in test mode: | ||
+ | * All 3 or 4 digit numbers pass as valid CVCs. | ||
+ | * All future expiration dates are considered valid. | ||
+ | |||
+ | To simulate the 'Card Declined' | ||
+ | |||
+ | ===== Troubleshooting & Interpreting Response Codes ===== | ||
+ | Contact stripe for info. <wrap help> | ||
+ | |||
+ | ==== User Notes and Experiences ===== | ||
+ | <wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</ |