🔗Payment Links

Generate a URL — to share with customers or clients — to accept a crypto payment using an iFrame, redirect, or standalone webpage

Merchants can create a payment link using the Swapped dashboard or API.

From your account, navigate to the Payment Links section. Once there, click the "Create Payment Link" button in the top right. Then simply fill out the information for the payment:

  • Name: The payment title that will be visible to customers using the payment link.

  • Internal Note (Notes): This field will not be visible to end-customers, and can be used as an internal note for any purpose.

  • Image (Optional): An image/icon that will be visible to customers using the payment link, and when receiving payment completed emails.

  • Currency: The fiat currency to be displayed on the payment link

    • Note: You can select any fiat currency when creating a payment link; however, your Swapped Commerce account will only denominate in 1 base fiat currency. For example, you can create payment links in 20+ currencies, but you'll only be able to settle and withdraw 1 single fiat currency.

  • Amount: The amount of fiat currency to charge a customer.

Notes

Sandbox

If you wish to test a payment link, add testMode: true to the request body data. Then visit the URL and proceed with a test payment. You will still receive webhooks in this mode.

Autofill Customer Data

If you have your customers name or email, autofill it in the metadata.customerName or metadata.customerEmail fields. Then when a customer visits the URL, they can skip this step in the payment.

Default Payment Cryptocurrency

To define the preferred cryptocurrency your end-customer will view when they load the payment link. For example, to set the default cryptocurrency as USDT on Tron add this to your request:

Create an order

post

Create a payment order

Authorizations
X-API-KeystringRequired
Body
testModebooleanOptionalDefault: false
Responses
200

Successful

*/*
post
/v1/orders
200

Successful

Last updated