Create a payment link

Payment links have a no-code option, where you can generate a payment page with the web application and begin collecting payments in seconds.

You can perform all the actions of payment links from the web application - create, activate and deactivate. Alternatively, you can extend the functionality and generate payment links programmatically at scale using the Speed platform API, in addition to the benefits of this no-code option.

Let's see this and more.

Create payment link via the web application

Log in to your account and follow the steps below to create a payment link.

  1. On the left sidebar, click Payment Link.
  2. Click Create new.
  3. After clicking the Create new button, you are redirected to a Create page. Fill out the required details.
  4. Click the create payment link button. This will redirect you to the detail page, where you can see the payment link you created and its details, like all the payments made via this link.
  5. Now, share it and get paid.

Create payment link via API

Create a payment link using the /payment-links endpoint and basic details such as amount, currency, statement descriptor, and others. In this example below, we'll show you how you can create a payment link for your customer on a purchase of 200 USD.

Make a POST /payment-links request specifying the following mandatory parameters.

  • amount
  • currency
{

"currency": "USD",

"amount": 200,

}

You can also include other optional parameters, for example, statement descriptor. If optional parameters are not specified, then the payment page will be rendered without a description.

Request parameters

Provide the basic information outlined in the table below:

ParameterRequiredTypeDescription
AmountBigDecimalThis is the total amount you intend to collect from the customer via the payment link. Please add a positive value. Values up to 32 digits can be handled by the amount param, which can have a decimal precision of up to 16 digits.
CurrencyStringIn this parameter, you must specify your preferred base currency (fiat or cryptocurrency) to create a checkout link. A three-lettered ISO-compliant currency name must be used. You can choose one of the 167 available currencies.
Statement descriptorStringCustomers need this information because it describes the purpose of payment. Keep this text brief and to the point. On the payment page, this description will be visible.

More information can be found in our API reference.

Response attributes

Your response contains the following attributes:

{
  "id": "plink_test_l9416770zIfz6Vd",
  "object": "payment.link",
  "livemode": false,
  "status": "active",
  "url": "https://buy.tryspeed.com/plink_test_l941678zIf3z6Vd",
  "currency": "USD",
  "amount": 6.9,
  "target_currency": "SATS",
  "statement_descriptor": null,
  "created": 1665487320656,
  "modified": 1665782320656
}
Attributes

id string
Unique identifier for the object.


object string
The type of the object indicates to which entity this response belongs.


livemode boolean
If the object is in live mode, it has the value true; otherwise, it has the value false.


status string
A payment link can have 2 statuses as mentioned below.

    active
    Upon generation, by default, it will be active until deactivated.
    deactivated
    You can manually deactivate a payment link when you don't intend to get paid via it.


url string
The public URL that can be shared with your customers to receive payments.


currency string
Your preferred currency (base currency) in which you want to create a payment link.


amount BigDecimal
Total amount for which the payment link was created. Values up to 32 digits can be handled by the amount param, which can have a decimal precision of up to 16 digits.


target_currency string
The cryptocurrency in which you want to receive payment from your customer. As of now, Speed only supports SATS.


statement_descriptor string
Additional information about a payment made to an account via this payment link.


created timestamp
Time at which the payment link was created.


modified timestamp
Time at which the last modification was made.


Before you begin

Before you begin to integrate the payment link APIs, make sure you have followed these steps.The prerequisite steps to accept payments through APIs are listed below

  1. Set up your test account.
  2. Create your API key in order to create payment links.

Set up webhooks to monitor the outcome. Notifications allow you to receive payment updates after you've sent the payment link to your shopper.