Documentation You are here: start » gateways » square

This is an old revision of the document!

Table of Contents

type:
gateway
name:
Square
countrie:
AU, CA, GB, JP, US
support-added:
2.0
supports-3dsecure:
yes
gateway:
https://squareup.com

Square

Setting Up Square for Foxy

  1. Create your account here.
  2. Go to the Payment Settings page in the Foxy administration.
  3. Once logged in, make sure your store is set to “Live Servers”
  4. Go to the Accept payments using your Square account option, check the box, and click the Connect to Square button.
  5. Sign into your Square account. Allow the app access to the Square account.
  6. Once returned to the Foxy admin with Square successfully connected:
    • check the show credit card form box,
    • select the Payment location
    • save the configuration

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 Square credit card input.

Please note that when using the Square 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 Square option shows a credit card form within the checkout already, and only one is allowed on the checkout at a time.

Testing

Obtaining a Test Account

Sign up for a Sandbox account here: https://squareup.com/

How to connect sandbox account to Foxy

  1. Once you've created your account, if you need to, login into SquareUp
  2. Go to https://developer.squareup.com/apps
  3. Scroll to Sandbox Test Accounts
  4. Click on the Launch button for the Sandbox account you want to activate
  5. Login into the Foxy admin and go to payment.
  6. Make sure which servers do you want to use? in the gateway screen is set to Test servers
  7. Go to the Accept payments using your Square account option, check the box, and click the Connect to Square button.
  8. Once returned to the Foxy admin with Square successfully connected, select the Payment location and save the configuration. 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 Square credit card input.

If you see the following error when trying to connect:

You'll want to review the steps just above to make sure that you have a sandbox account with Square and that you've logged into the account and launched the seller test account from the Developer Dashboard in Square.

Test Card Numbers

Generating success states

Brand Number CVV
Visa 4111 1111 1111 1111 111
MasterCard 5105 1051 0510 5100 111
Discover 6011 0000 0000 0004 111
Diners Club 3000 0000 0000 04 111
JCB 3569 9900 1009 5841111
American Express3400 000000 00009 1111
China UnionPay 6222 9888 1234 0000123

Generating error states

Desired error state Test values
Card CVV incorrect Use 911 as the CVV
Card postal code incorrect Use 99999 as the postal code
Card expiration date incorrect Use 01/40 as the expiration date

Troubleshooting & Interpreting Response Codes

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

Important Notes and Caveats

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.

Page Tools

Site Tools