9 min read • Updated 4 months ago
Square
Connect Foxy to Square for secure payments.
- Countries
Belgium, France, United States
- Features
- 3-D Secure
- Auth Only & Delayed Capture
Setting Up Square for Foxy
Through a partnership with Square, new signups in the US and Canada are able to profit from up to $2,000 in fee free processing. If you're based in the US, sign up here, or in Canada, sign up here.
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.
Customer Deduplication & Privacy Considerations
Per Square’s direction, we have added Square's customer deduplication functionality for guest customers as well as non-guest customers. This is generally a helpful thing, as you can use your customer records in Square for a variety of things; and if a customer checks out multiple times in Foxy as a guest, they'll only show up once in Square.
Although Foxy doesn't create customers in Square if they don't already exist - if a matching customer is found, then that Square customer ID will be used for the transaction.
It's important to understand, however, that there's no email verification or other authentication for guest checkouts in Foxy. Though very, very unlikely to be an issue, we do want to make it clear that just because two orders in Square may show as being from the same customer, it doesn’t mean the same person necessarily placed both orders. If a customer says “Hey, I just placed an order ID12345, but I need to know what my previous shipping address was on my last order,” be aware of the security considerations. (A good example to keep in mind is somebody in an abusive relationship or being stalked. Verify whom you're talking with before you share personal info.)
This is good advice in general, but because we use existing Square customer records even for guest checkouts on Foxy, and because you may use the Square customer functionality more than Foxy's, it's something we want to point out.
Testing
Obtaining A Test Account
Sign up for a Sandbox account here: https://squareup.com/
How To Connect Sandbox Account To Foxy
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 5841 | 111 |
American Express | 3400 000000 00009 | 1111 |
China UnionPay | 6222 9888 1234 0000 | 123 |
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.