创建静态钱包

创建静态钱包

URL

需要授权

POST

https://api.fps.pro/invoices/wallet

请求格式application/json

token

required

string

用于创建静态钱包的代币代码

network

required

string

用于创建静态钱包的网络代码

order_id

required

string

您系统中的订单 ID

webhook_link

url

支付状态回传的 URL

默认值: merchant settings

响应格式data object

id

uuid

静态钱包 ID

order_id

string

您系统中的订单 ID

address

string

接收付款的最终地址

token

string

代币代码

network

string

网络代码

请求示例

curl --request POST 'https://api.fps.pro/invoices/wallet/' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Timestamp: 1720000000' \
  --header 'X-Signature: YOUR_HMAC_SHA256_SIGNATURE' \
  --data '{
  "token": "tether",
  "network": "tron",
  "order_id": "ORD-1001",
  "webhook_link": "https://merchant.example.com/webhooks/static-wallet"
}'

成功响应

{
  "status": 200,
  "message": "wallet created",
  "data": {
    "id": "95b97d47-4f0f-4822-8f26-4c3550fd1b7a",
    "order_id": "order-1001",
    "address": "TQ5x...abc",
    "token": "tether",
    "network": "tron"
  }
}

错误

详细的授权错误列表位于 授权 - 错误

{
  "status": 422,
  "message": "Validation Error",
  "errors": [
    {
      "field": "token",
      "message": "token is required"
    }
  ]
}
{
  "status": 404,
  "message": "No token/network pairing found"
}
{
  "status": 500,
  "message": "Internal Server Error"
}