Testing

Testing in Unsupported Regions

Testing recommendations for developers in unsupported regions.

Currently, Square APIs are only supported for accounts based in the United States, Canada, Australia, the United Kingdom, and Japan. We are working to make them available in additional countries soon.

If you are a developer trying to build on Square APIs for a Seller based in a Square-supported country, we recommend the following testing solutions:

  • Testing eCommerce payment APIs for the account default country in sandbox Use the v2 Sandbox default testing account credentials to test payment-related APIs.

  • Testing eCommerce payment APIs for other supported countries in sandbox — In the v2 Sandbox, add a testing account for the location you are testing and then use the sandbox credentials for that account to test. payment-related APIs.

  • Testing non-payment APIs or eCommerce payment APIs in production — Ask the Seller based in a Square-supported country that you are working with to provide you with a valid application ID and/or personal access token. Payments must use the currency of the Seller account so we recommend hiring beta testers in a Square-supported country to test your functionality before release.
    Note: v2 Sandbox supports testing eCommerce payment APIs in the sandbox environment and applies all payment validation rules to simulate production payments in that location. It is no longer necessary to test payments in production code.

  • Testing in-person payment APIsReader SDK and POS SDK are not supported in v2 Sandbox and Square hardware only works in Square-supported countries. Test payment requests for in-person payments in production using the CASH tender type.