支付信息

查看您的支付状态

URL

需要授权

GET

https://api.fps.pro/invoices/{invoice}

请求格式pathParam

invoice

required

uuid

发票 ID

响应格式data object

id

uuid

发票 ID

info.currency

string | null

发票的法币代码

info.token

string | null

支付代币

info.network

string | null

支付网络

info.address

string | null

用于支付的钱包地址

amount.starting_price

number

发票的初始法币金额

amount.discount_percent

number

折扣百分比

amount.merchant_fee_percent

number

商户手续费百分比

amount.service_fee_percent

number | null

平台服务费百分比

amount.total

number

折扣和手续费后的最终金额

url.webhook

url | null

商户 Webhook URL

url.success

url | null

支付成功后的跳转 URL

url.error

url | null

支付失败后的跳转 URL

url.payment

url

支付页面链接

options.part_payment

boolean

是否允许部分付款

options.ignore_client_amount

boolean

是否忽略客户的精确金额

options.payment_accuracy

number

允许的付款误差

additional.order_id

string | null

外部订单 ID

additional.info

string | null

订单附加信息

status

string

发票当前状态

expired_at

string (ISO 8601, UTC)

发票过期日期

created_at

string (ISO 8601, UTC)

发票创建日期

payment.transactions

array

传入区块链交易列表

payment.transactions[].txid

string | null

交易哈希

payment.transactions[].from

string | null

发送方地址

payment.transactions[].amount

string | null

以代币最小单位表示的传入交易金额

payment.fiat_payment_amount

number

已支付的法币金额

payment.service_fee_amount

number

以法币计的累计服务费

请求示例

curl --request GET 'https://api.fps.pro/invoices/0a718b02-131d-495a-9641-39ca52139c07' \

成功响应

{
  "status": 200,
  "message": "success",
  "data": {
    "id": "0a718b02-138d-495a-9661-39ca52139c07",
    "info": {
      "currency": "USD",
      "token": "tether",
      "network": "tron",
      "address": "TQ5x...abc"
    },
    "amount": {
      "starting_price": 1000,
      "discount_percent": 0,
      "merchant_fee_percent": 10,
      "service_fee_percent": 1,
      "total": 1100
    },
    "url": {
      "webhook": "https://merchant.example/webhook",
      "success": "https://merchant.example/success",
      "error": "https://merchant.example/error",
      "payment": "https://frontend.example/0a718b02-138d-495a-9661-39ca52139c07"
    },
    "options": {
      "part_payment": true,
      "ignore_client_amount": false,
      "payment_accuracy": 0
    },
    "additional": {
      "order_id": "1",
      "info": "test order"
    },
    "status": "paid",
    "expired_at": "2026-01-05 14:30:43",
    "created_at": "2026-01-05T13:30:43.000Z",
    "payment": {
      "transactions": [
        {
          "txid": "f4d4f497e6b32b6a4b8e...",
          "from": "TFgN...sender",
          "amount": "1100000000"
        }
      ],
      "fiat_payment_amount": 1100,
      "service_fee_amount": 11
    }
  }
}

错误

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

{
  "status": 422,
  "message": "Validation Error",
  "errors": [
    {
      "field": "invoice",
      "message": "The invoice must be UUID."
    }
  ]
}
{
  "status": 404,
  "message": "The invoice is not found"
}
{
  "status": 500,
  "message": "Internal Server Error"
}