Documentation You are here: start » gateways » stripe
type:
gateway
name:
Stripe
countrie:
AU, AT, BE, CA, DK, FI, FR, DE, HK, IE, IT, JP, LU, NL, NZ, NO, PT, SG, ES, SE, CH, GB, US, BR, MX
support-added:
0.7.2
supports-multicurrency:
yes
gateway:
http://stripe.com/

Stripe

Setting Up Stripe for FoxyCart

  1. Create your account here.
  2. Click on “API” in sidebar navigation.
  3. Click on “Reveal live key token”
  4. Copy Secret Key that is revealed.
  5. Go to the Payment Settings page in the FoxyCart administration.
  6. Once logged in, make sure your store is set to “Live Servers”
  7. Choose Stripe as your “bank card payment method”.
  8. Paste your “Secret Key” into the “Secret Key” field.

Stripe Tokenization and "Unsafe" Processing Errors

Stripe recently made some changes in how they handle integrations like FoxyCart's that communicate directly with their API and securely include the customer's credit card details as part of the API request. Stripe is recommending that users make use of their tokenization integration options, so that the merchants don't have to handle credit card numbers at all. As you are making use of FoxyCart for your store, we (as a PCI DSS Level 1 Service Provider) securely handle the customer's payment details for you, meaning you don't have to handle them either.

Depending on when your account was created, you may receive an email from Stripe noting that you need to enable either tokenization or “Unsafe Processing”, or you might see an error message like this in FoxyCart when attempting to process a transaction:

Sending credit card numbers directly to the Stripe API is generally unsafe. To continue processing use Stripe.js, the Stripe mobile bindings, or Stripe Elements. For more information, see https://dashboard.stripe.com/account/integration/settings.

If you see either of those things, you'll need to enable “Unsafe Processing” within your Stripe account. To do that, follow these steps:

  1. Either click the link above, or in the Stripe dashboard go to “Business Settings” and then to “Integration”.
  2. On the Integration settings page, click the “Show Advanced options” link, and toggle the “Process payments unsafely” option.
  3. This will load a popup window with three checkboxes, check each one and for the final one, in the dropdown that appears select “Someone else built my Stripe integration”, and specify “FoxyCart” in the textbox.
  4. Finally, click the “Process payments unsafely” button to save the changes.

The language around this option is quite concerning, but rest assured that FoxyCart is securely handling the customer payment data, and the approach we take for our Stripe integration is exactly how we approach our other gateway integrations too.

We are also looking at ways that we can work with Stripe's other recommended options to remove the need to enable this option in Stripe when using FoxyCart.

Supported Countries

Stripe is continually expanding the countries that they support. The good news is, FoxyCart's existing Stripe integration should support any new countries that they do add support for. For a list of the countries that Stripe currently support, see this page on their site.

Testing

Obtaining a Test Account

Contact stripe for info. Know more? Feel free to edit this page with info.

Test Card Numbers

You can use 4242424242424242 to simulate successful card validations in test mode (this number fails in production of course).

Technically, any card number that passes the Luhn Check will validate successfully in test mode – this includes real credit card numbers. You might not want to use real card numbers while testing though, to avoid accidentally checking them into your codebase.

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' error use this special card number - 4000000000000002.

Troubleshooting & Interpreting Response Codes

Contact stripe for info. Know more? Feel free to edit this page with info.

Important Notes and Caveats

Put your Stripe “Secret API Key” in “API ID” box when setting up FoxyCart.

User Notes and Experiences

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. We reserve the right to edit or remove comments that don't add value to this page.

Site Tools