Create a payment link

post

https://api.tryspeed.com/payment-links

The payment link is a shareable URL that directs your customer to a payment page where they can make an on-chain, ethereum, solana, tron or a lightning payment.

A payment link can be shared and used multiple times to accept payments from your customers. You can generate a payment link in your preferred base currency in order to be paid in target cryptocurrency supported by the Speed platform API.

Body Params

currency

string

required

Defaults to USD

In this parameter, you must specify your preferred base currency (fiat or cryptocurrency) to create a payment link. A three-lettered ISO-compliant currency name must be used.

amount

string

required

Defaults to 200

The total amount that you intend to collect from your customers.

If you want your customer to pay the fixed amount that you have set, the amount value must be greater than zero and type does not need to be defined.
However, if you want your customer to decide how much to pay, you can either set the amount to 0 or you must designate the type as either "preset" or "options" and set values to it.

type

string

enum

This parameter allows you to specify the preferred payment method for customers. If you want your customer to choose what to pay then you need to set the type to either "preset" or "options".

Allowed:

preset

object

If you’ve set the "type=preset" you can specify a minimum and maximum payment amount for your customers in this field and then they'll pay only within this range.

options

array of strings

If you’ve set the "type=options" you must provide this field wherein you can offer your customers a selection of up to three payment amount options.

options

customer_collections_status

object

Use this parameter if you wish to collect the below mentioned options from the customer.

custom_fields

array of objects

You can use this parameter to collect specific information from users while they are on payment page.

custom_fields

success_url

string

If the payment is successful, the customer will be redirected to this URL.

success_message

string

Message customers will see when they make payment via their wallet. Success_url and success-message are mutually exclusive request parameters—only one of them can be used.

title

string

You can use this parameter to add the header or title to your payment page.

title_description

string

You can use this parameter to provide a brief description of your payment page.

title_image

string

You can include a related image illustrating the purpose of a payment page along with the title and description. Image size must not be more than 2 MB.

metadata

json

Defaults to { "key_1": "value_1", "key_2": "value_2" }

You can use this to store additional information about the object in a structured format. In this parameter, you can add up to 50 key-value pairs in a raw JSON format.

cashback

object

Use this parameter to associate an active cashback with a payment link.

Headers

speed-version

string

enum

Defaults to 2022-04-15

In this parameter, you can specify the version you want. As of now, there are two versions (2022-04-15 and 2022-10-15). Version 2022-10-15 supports on-chain, lightning, Ethereum, Solana and Tron payment methods. Whereas the 2022-04-15 version only supports lightning payments.

Allowed:

Response

Language

Credentials

Basic

base64

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200