API – Tạo ví tĩnh

Tạo ví tĩnh

URL

POST

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

Định dạng yêu cầuapplication/json

`token` required string	Mã token dùng để tạo ví tĩnh
`network` required string	Mã mạng dùng để tạo ví tĩnh
`order_id` required string	ID đơn hàng trong hệ thống của bạn
`webhook_link` url	URL nhận trạng thái thanh toán Mặc định: merchant settings

Định dạng phản hồidata object

`id` uuid	ID ví tĩnh
`order_id` string	ID đơn hàng trong hệ thống của bạn
`address` string	Địa chỉ cuối để nhận thanh toán
`token` string	Mã token
`network` string	Mã mạng

Ví dụ yêu cầu

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"
}'

Phản hồi thành công

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

Lỗi

Danh sách lỗi ủy quyền chi tiết nằm trong Ủy quyền - Lỗi

{
  "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"
}