Danh sách ví

Danh sách ví tĩnh của bạn

URL

Yêu cầu ủy quyền

GET

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

Định dạng yêu cầupathParam

order_id

string

ID đơn hàng trong hệ thống của bạn

token

string

Mã token đã dùng để tạo ví tĩnh

network

string

Mã mạng đã dùng để tạo ví tĩnh

page

integer

Phân trang

Mặc định: 1

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

data[].id

uuid

ID ví tĩnh

data[].order_id

string

ID đơn hàng trong hệ thống của bạn

data[].address

string

Địa chỉ cuối để nhận thanh toán

data[].token

string

Mã token

data[].network

string

Mã mạng

Ví dụ yêu cầu

curl --request GET 'https://api.fps.pro/invoices/wallet/?order_id=ORD-1001&token=tether&network=tron&page=1' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Timestamp: 1720000000' \
  --header 'X-Signature: YOUR_HMAC_SHA256_SIGNATURE'

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

{
  "status": 200,
  "message": "ok",
  "data": [
    {
      "id": "95b97d47-4f0f-4822-8f26-4c3550fd1b7a",
      "order_id": "order-1001",
      "address": "TQ5x...abc",
      "token": "tether",
      "network": "tron"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 20,
    "last_page": 1
  }
}

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": "page",
      "message": "page must be positive int"
    }
  ]
}
{
  "status": 400,
  "message": "Token is not exist"
}
{
  "status": 400,
  "message": "Network is not exist"
}
{
  "status": 500,
  "message": "Internal Server Error"
}