An application can generate a quick pay checkout page (see Checkout API Overview) to allow a seller to sell an ad hoc item and get paid (without specifying an Order object in the request). The application can then embed the link in the application or send it to the buyer using, for example, email or social media.
The CreatePaymentLink request requires only the item name, price, and seller location. The following example request creates a quick pay checkout page for $125 for auto detailing:
Create payment link
After receiving the requests, Square creates the following:
- An Order - The
price_moneymap to the order line item
base_price_amount. Note that the
stateof the order created is
DRAFT. After the buyer pays for the order, the
- A PaymentLink object - It provides, among other things,
URLto the checkout page that Square renders when requested.
An example response is shown:
Note the following about information in the response:
- The seller can send or display the checkout page to the buyer to take payment. The buyer can use the payment link only once.
The following describes the buyer experience and relevant updates that occur after the buyer pays for the order. Note that the screenshots shown reflect the buyer experience in production. In the Sandbox, you can take a payment and verify it, but the UI experience isn't the same as in production.
The buyer opens the URL, which opens the Square-hosted checkout page where the buyer can make a payment. The following is an example screenshot.
Note the following about the checkout page:
- The checkout page shows the primary business name as configured in the seller's Square account.
- If the buyer 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, show the Apple Pay option when the buyer is using Safari. For more information about available payment methods, see AcceptedPaymentMethods and Guidelines and Limitations.
Square processes the buyer's payment as follows:
Displays the order confirmation page. The following is an example Square-provided confirmation page:
If you provided a redirect URL in the request, Square redirects the buyer to that page instead.
Sends a Square receipt to the email address that the buyer provided during checkout.
Sends a "payment received" email notification to the seller. The notification is sent to the primary email address associated with their Square account. Note that sellers can enable or disable email notifications in the Seller Dashboard by choosing Online Checkout, and then choosing General under Settings.
Updates the Order as follows:
- Adds a
Tenderobject to the order. It describes the tender used to pay for the order. Note that the
Tender.ididentifies the associated
Paymentobject that was created. You can use the Payments API to access the payment.
- After the order is paid by the buyer, the order is shown in Order Manager in the Seller Dashboard. For example, you can open the Seller Dashboard, choose Orders, and review the order (