> For the complete documentation index, see [llms.txt](https://docs.velafi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velafi.com/guides/stablecoin-payments/create-a-payment-link.md). # Create a Payment Link This API is used to create a stablecoin payment link that can be shared with users to facilitate on-chain stablecoin payments.\ A payment link includes key information such as the payment amount, currency, wallet, and expiration time. Users can initiate payments through the link within its validity period. * Once the user completes the on-chain transfer, a corresponding payment order is automatically generated * Payment links are strictly bound to the merchant and wallet * Expired payment links are no longer usable 📌 For the currently supported blockchain networks and cryptocurrencies, please refer to the following list.
CurrencyCoin IDNetwork / Standard
USDT2Binance Smart Chain (BEP20)
USDT2Ethereum (ERC20)
USDT2Polygon (POS)
USDT2Solana (Mainnet)
USDT2TRON (TRC20)
USDC3Ethereum (ERC20)
USDC3Polygon (POS)
USDC3Solana (Mainnet)
*** * **Request Header: X-BH-TOKEN: `******`** * **Request Header: Content-Type: `application/json`** * **Request Method: `POST`** * **Request Path: `/v2/payments/link`** * **Authorization Required:** Yes *** ### Request Parameters The request body should include the following parameters: * userId: User identifier. * merchantId: Merchant ID (required). * amount: Payment amount (required). * currency: Payment currency (required). * walletId: Wallet ID (required). * reference: Reference number for order tracking (required). * expireSeconds: Expiration time in seconds (default: 1). *** ### Request Example ```json { "userId": 1, "merchantId": 1, "amount": 100.00, "currency": "USDT", "walletId": 1, "reference": "INV-123456", "expireSeconds": 123 } ``` *** ### Response Parameters The response will contain the following parameters: * linkId: Payment link identifier. * paymentLink: Generated payment URL. *** ### Response Example ```json { "code": 200, "msg": "SUCCESS", "data": { "linkId": 1, "paymentLink": "https://example.com/pay/123456" } } ``` *** ### Notes * The `walletId` must belong to the specified merchant. * The generated `paymentLink` can be shared with users to initiate on-chain stablecoin payments. * Once the payment is completed on-chain, a corresponding payment order will be automatically generated by the system. * Expired payment links cannot be used to initiate new payments. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.velafi.com/guides/stablecoin-payments/create-a-payment-link.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.