Creating a Pre-order

To create a pre-order using SpectroCoin's API, you must first ensure that your API keys are properly configured. This is a prerequisite for making any requests and can be set up by following this guide on generating API keys. Additionally, a valid access token is required for authorization, to get one refer to this guide on getting an access token.

A pre-order link is a tool that allows merchants to generate multiple orders from a single link for goods or services at a fixed price.

How pre-order Links are useful?

Pre-order links simplify the process of accepting cryptocurrency payments for any fixed-price goods or services. By setting a fixed amount in advance, businesses can speed up transactions and reduce errors. These links are reusable, making them ideal for scenarios where customers need to pay a predetermined amount quickly and efficiently.

For retail shops, pre-order links are especially useful for integrating crypto payments into point-of-sale (POS) systems, ensuring fast and hassle-free transactions for standard products or services. They can also be used for recurring orders or fixed-price services that need to be processed quickly at checkout.

Example use cases

Collecting payments for retail products with fixed-price items such as clothing, electronics, or groceries.
In-store services with fixed-price services like haircuts, repairs, or consultations.
Managing subscription-based services.
Selling event tickets.
Handling custom invoicing.
Facilitating bulk or recurring orders.

How to create a pre-order link?

On any device (tablet, smartphone, or computer), log in to your SpectroCoin account. Navigate to the Business tab and select the appropriate project.
Click on Create Order.
Enter the order details and click Submit. The Order price is the only required field; all other fields are optional.

If you are selling goods or services at a fixed price, you can create a pre-order link using the Allow multiple payments feature. This allows for multiple orders to be generated from a single pre-order link, enabling the creation of numerous orders based on that link.

Please note that if the Auto-convert received currency function is enabled, you will receive all payments in your selected currency. If this feature is not enabled, payments will be received in the customer’s chosen currency.

Create pre-order via API

Pre-orders can be easily created usingPOST /public/merchants/preorders endpoint.

Example request

{
    "orderId": "sc-9154",
    "description": "example pre-order",
    "merchantProjectId": "22815ga6-acg8-ab36-g132-5g6dan2d82a56",
    "receiveAmount": 10,
    "receiveCurrencyCode": "BTC",
    "isNotify": true,
    "isMultiple": true
}

The key feature of pre-orders is the isMultiple parameter. When set to true, it allows multiple payments to be made using the same pre-order. Furthermore, if the isNotify parameter is set to true, the merchant will receive an automated email notification from SpectroCoin whenever a payment is received.

Example response

{
    "id": "1cc76d0c-6196-4b99-9ef8-7c4de5a81352",
    "merchantProjectId": "22815ga6-acg8-ab36-g132-5g6dan2d82a56",
    "orderId": "sc-9154",
    "receiveAmount": "10",
    "description": "example pre-order",
    "callbackURL": null,
    "successURL": null,
    "failureURL": null,
    "isMultiple": true,
    "isNotify": true,
    "receiveCurrencyCode": "BTC",
    "company": "EE",
    "created": "2024-09-25T11:59:29.555524662",
    "redirectURL": "https://pp.spectrocoin.com/en/payment/preorder/1cc76d0c-6196-4b99-9ef8-7c4de5a81352"
}