create-payment-link-request.md

Create Payment Link Request

Structure

Create Payment Link Request

Fields

Name	Type	Tags	Description
idempotency_key	String	Optional	A unique string that identifies this CreatePaymentLinkRequest request. If you do not provide a unique string (or provide an empty string as the value), the endpoint treats each request as independent. For more information, see Idempotency. Constraints: Maximum Length: 192
description	String	Optional	A description of the payment link. You provide this optional description that is useful in your application context. It is not used anywhere. Constraints: Maximum Length: 4096
quick_pay	Quick Pay Hash	Optional	Describes an ad hoc item and price to generate a quick pay checkout link. For more information, see Quick Pay Checkout.
order	Order Hash	Optional	Contains all information related to a single order to process with Square, including line items that specify the products to purchase. Order objects also include information about any associated tenders, refunds, and returns. All Connect V2 Transactions have all been converted to Orders including all associated itemization data.
checkout_options	Checkout Options Hash	Optional	-
pre_populated_data	Pre Populated Data Hash	Optional	Describes buyer data to prepopulate in the payment form. For more information, see Optional Checkout Configurations.
source	String	Optional	The application that created the payment link.
payment_note	String	Optional	A note for the payment. After processing the payment, Square adds this note to the resulting Payment. Constraints: Maximum Length: 500

Example (as JSON)

{
  "idempotency_key": "cd9e25dc-d9f2-4430-aedb-61605070e95f",
  "quick_pay": {
    "location_id": "A9Y43N9ABXZBP",
    "name": "Auto Detailing",
    "price_money": {
      "amount": 10000,
      "currency": "USD"
    }
  }
}