查询付款批次

TIMESTAMP=$(date +%s)
NONCE=$(uuidgen)
BODY=''
SIGNATURE=$(printf '%s' "${TIMESTAMP}.${NONCE}.${BODY}" | openssl dgst -sha256 -hmac "${SECRET_KEY}" | awk '{print $NF}')

curl --request GET --get "https://api.stablepay.co/api/v1/payout-batches/${BATCH_ID}" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "X-StablePay-Timestamp: ${TIMESTAMP}" \
  -H "X-StablePay-Nonce: ${NONCE}" \
  -H "X-StablePay-Signature: ${SIGNATURE}"

{
  "code": 401,
  "message": "authenticated merchant is required",
  "errorCode": "authentication_required",
  "data": null
}

{
  "code": 403,
  "message": "access denied",
  "errorCode": "forbidden",
  "data": null
}

{
  "code": 404,
  "message": "batch not found",
  "errorCode": "batch_not_found",
  "data": null
}

{
  "code": 500,
  "message": "payout request failed",
  "errorCode": "payout_error",
  "data": null
}

{
  "code": 503,
  "message": "payout service is temporarily unavailable",
  "errorCode": "service_unavailable",
  "data": null
}

GET

api

payout-batches

{batch_id}

TIMESTAMP=$(date +%s)
NONCE=$(uuidgen)
BODY=''
SIGNATURE=$(printf '%s' "${TIMESTAMP}.${NONCE}.${BODY}" | openssl dgst -sha256 -hmac "${SECRET_KEY}" | awk '{print $NF}')

curl --request GET --get "https://api.stablepay.co/api/v1/payout-batches/${BATCH_ID}" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "X-StablePay-Timestamp: ${TIMESTAMP}" \
  -H "X-StablePay-Nonce: ${NONCE}" \
  -H "X-StablePay-Signature: ${SIGNATURE}"

{
  "code": 401,
  "message": "authenticated merchant is required",
  "errorCode": "authentication_required",
  "data": null
}

{
  "code": 403,
  "message": "access denied",
  "errorCode": "forbidden",
  "data": null
}

{
  "code": 404,
  "message": "batch not found",
  "errorCode": "batch_not_found",
  "data": null
}

{
  "code": 500,
  "message": "payout request failed",
  "errorCode": "payout_error",
  "data": null
}

{
  "code": 503,
  "message": "payout service is temporarily unavailable",
  "errorCode": "service_unavailable",
  "data": null
}

批次不存在时返回 404 batch_not_found；当前商户无权访问时返回 403 forbidden。商户身份由 stablepay-auth 的认证结果确定，请求参数不得传入 merchant_id。批次状态和业务规则以 StablePay Payout 服务为准。

认证与请求头

使用 Bearer API Key 和以下三个签名请求头。使用 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256，并转换为小写 hex。签名使用实际发送的原始请求体；不发送请求体时使用空字符串。详见认证与签名。

string

必填

Bearer API Key: Bearer sk_live_xxx.

string

必填

Unix 时间戳（秒），与服务器时间相差不超过 5 分钟。

string

必填

防重放随机字符串，每次请求使用新的 nonce。最短字符数：16。最长字符数：64。

string

必填

请求签名，使用小写十六进制编码。

路径参数

string

必填

最短字符数：1。最长字符数：64。

成功响应

HTTP 200, application/json. 查询成功。对象仅允许包含下列已定义字段。

string

必填

string

必填

可选值：draft、needs_fix、pending、pending_approval、processing、partially_completed、completed、failed、canceled、rejected。

string

必填

可选值：USDT、USDC。

string

必填

可选值：erc20、trc20、spl。

integer

必填

最小值：0。

integer

必填

最小值：0。

integer

必填

最小值：0。

integer

必填

最小值：0。

integer

必填

最小值：0。

string

必填