Create Payment Link

POST

/api/v3/payment-link/create

Create a payment link via API. Supports both one-time payment and subscription payment types. Currently only supports Ethereum network with the following currencies: ETH, USDT, USDC, SHIB, DAI, UNI, LINK, AAVE, MKR

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Created Successfully

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

cURL

One-time payment example (USDT)One-time payment example (ETH)One-time payment example (USDC)Recurring subscription payment

curl --location '/api/v3/payment-link/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "paymentLinkName": "Product Payment Link",
    "paymentLinkDescription": "Payment link for product purchase",
    "paymentLinkType": 1,
    "paymentLinkSingle": {
        "singleType": 1,
        "singlePrice": 100,
        "settlementCurrency": "USDT",
        "receivingCurrencyList": [
            "USDT"
        ],
        "network": "Ethereum"
    },
    "paymentLinkSetting": {
        "isPaymentFeeCoveredByPayer": "false"
    }
}'

Response Example

200 - 成功示例

{
    "code": 200,
    "message": "success",
    "data": {
        "paymentLinkUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "paymentLinkUrl": "https://example.com/shopping/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "paymentLinkAddress": "0x1234567890abcdef1234567890abcdef12345678",
        "createTimeUtc": "2026-02-03 12:00:00"
    }
}

Modified at 2026-05-27 09:48:31

Payment Links

Update Payment Link