Customize checkout for Payment Links

When you create a payment link, you can customize the look and feel of a checkout session for your user. You can also choose what type of customer information to collect and save for later.

See After a payment link payment for more information about customizing a session post-payment, such as redirecting the customer to a branded confirmation page or emailing a receipt.

Limit the number of times a payment link can be paid

You can limit the amount of times a payment link is paid for. This is helpful, for example, if you have limited inventory, or only want the links to be used once. When the payment link reaches the limit, it automatically deactivates and customers can’t use it to make a purchase. If a customer tries to open the link after the limit has been reached, they’re shown the default message for deactivated links or a message that you can customize.

To limit the number of payments using the Dashboard:

1. Create or edit a payment link.
2. Select Limit the number of payments and enter the number of payments you want to allow before the link deactivates.

Set a custom message for deactivated links

If customers try to open a deactivated payment link, they’re shown a default message. You can customize this message in the Dashboard or with the API.

You can customize the message for a deactivated link in the Dashboard in two ways:

• When you create or edit a payment link, select Limit the number of payments. Then select Change deactivation message and add your custom message.
• When you attempt to deactivate a payment link, a modal with a prompt to change the default deactivation message appears. Use that to update the message.

Collect customer addresses and phone numbers

You can collect addresses and phone numbers with payment links by adding those fields to the checkout session.

Collect an address

1. Create or edit a payment link. To edit a payment link go to its details page and click the overflow menu (...).
2. Select Collect customers’ addresses in the Options section.
3. You can collect Billing addresses only or you can collect Billing and shipping addresses. Choosing either makes these fields required for customers. (comming soon)
4. If you collect shipping addresses: (comming soon)
   • You need to select the countries you ship to. These countries appear in the Country dropdown in the Shipping Address form in the checkout session.
   • You can optionally add shipping rates.

Collect a phone number

If you need to collect phone numbers to complete the transaction:

1. Create or edit a payment link.
2. Select Require customers to provide a phone number.

Add custom fields

You can add custom fields on the payment form to collect additional information from your customers. The information is available after the payment is complete and is useful for fulfilling the purchase. You can add the following types of fields.

1. Click Add custom fields in the Options section.
2. Select a type of field to add.
3. Enter a label for the field.
4. (Optional) Mark your field as required.

Labels for custom fields aren’t translated, but you can use the locale URL parameter to set the language of your payment link to match the same language as your labels.