Speed platform API brings you a range of core resources that you can integrate into your product such as checkout links, payments, payment link and many others. You can request a checkout link in your preferred base currency, in order to be paid in cryptocurrency supported by the Speed platform API (currently SATS only).
Checkout link API calls checkout session API to create a checkout link URL, which is used to accept one-time full payment until they are fully paid or deactivated. Checkout links are unique URLs that take your customer to a payment page. When a customer visits the checkout link URL, the payment page API is invoked in the background, which provides information such as payment QR code(BTC and lightning) and branding details. When you receive the full on-chain or lightning network payment, the checkout link status changes to paid. To ensure that you can receive both on-chain and lightning payments, remember to keep the “BTC On-chain” payment method enabled in payment methods in Speed web application.
{
"id": "clink_xxxxxxxxxxxxxxxxxxx",
"object": "checkout.link",
"livemode": true,
"payment_id": [
"pi_xxxxxxxxxxxxxxxx",
"pi_xxxxxxxxxxxxxxxx",
"pi_xxxxxxxxxxxxxxxxxx"
],
"status": "active",
"url": null,
"currency": "USD",
"amount": 2000,
"target_currency": "SATS",
"statement_descriptor": null,
"success_url": "https://www.tryspeed.com",
"success_message": "Thank you for the payment",
"metadata": {
"key_1": "value_1",
"key_2": "value_2"
},
"cashback": {
"id": "cb_xxxxxxxxxxxxxxxxx"
},
"created": 1652694517273,
"modified": 1652694517273
}
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.
payment_id array of strings
Each payment made through a checkout link will have associated payment_ids. This is an array containing either a list of partial payment ids or a single payment_id.
status string
A checkout link can have 3 statuses as mentioned below.
- unpaid
- The checkout link is unpaid after its generation until it is paid.
- paid
- The checkout link is already used and paid for by your customer.
- deactivated You can manually deactivate the checkout link (if not paid already) when you don't intend to get paid via it.
url string
The public URL that can be shared with customers to receive payments.
currency string
The base currency in which you prefer to work.
amount BigDecimal
Total amount for which the checkout link was created. Values up to 32 digits can be handled by the amount param, which can have a decimal precision up to 16 digits.
target_currency string
The cryptocurrency in which you want to receive payment from you customer. As of now, Speed only supports SATS.
statement_descriptor string
Additional information about a payment made to an account via this checkout link.
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.
metadata object
You can use this to store additional information about the object in a structured format.
cashback object
You can use this parameter to associate an active cashback with a checkout link.
- id string
- Unique identifier for the cashback object.
created timestamp
Time at which the checkout link was created.
modified timestamp
Time at which the last modification was made.