Learn about Square Checkout API guidelines and limitations.
Checkout API

Guidelines and Limitations

The following guidelines apply to Checkout API:

  • You cannot specify an existing order in a CreatePaymentLink request. You must include an order in the request body. After receiving the request, Square creates the order.

  • The Checkout API only supports subscription plans with one paid phase (or one free phase and one paid phase).

  • The Checkout API is available in all regions where Square accepts payments.

  • Cash App Pay is only available for sellers based in the United States.

  • Afterpay payments:

    • Afterpay is only available for sellers based in the United States and Australia.

    • Not all sellers are eligible for Afterpay. Certain business categories are prohibited from using Afterpay.

    • Afterpay can only be used for transactions in an eligible purchase range. The default ranges are based on the seller’s business type. They can consult their Afterpay account for more details.

  • Applications have the option to enable tipping on the checkout page. This option defaults to the Square-wide default tip settings for the country in which the seller is based. For example, this defaults to a 15% auto-tip in the United States and Canada.

  • The payment buttons that appear on the checkout page depend on the buyers device. If the hosting device (for example, a browser on your computer or a mobile phone) supports Apple Pay or Google Pay, the checkout page shows the payment button that best suits that browser. For example, it shows the Apple Pay option when the buyer is using Safari.

  • A payment link can only be used to accept payment from a single buyer.

If you need more assistance, contact Developer Support or ask for help in the Developer Forums.