查询 Payout

Quick Reference

What查询单个 payout

Why检查您创建的 payout 的当前状态和详情

Reading Time3 分钟

DifficultyBeginner

Prerequisites身份验证 → 一个 payout_uuid 及其资金来源 wallet_uuid

GET/api/v1/bank/wallet/payout/{payout_uuid}/{wallet_uuid}/Bearer Token查询绑定到钱包的 payout

payout 绑定到为其提供资金的钱包：payout_uuid 和 wallet_uuid 都在 URL 路径中。如果 payout 不属于该钱包，API 返回 errors.wallet.payout_not_found。

---

路径参数

字段	类型	必填	说明
payout_uuid	string (UUID)	是	要查询的 payout
wallet_uuid	string (UUID)	是	为 payout 提供资金的钱包

请求头

Header	值	必填
Authorization	Bearer {A55_ACCESS_TOKEN}	是

---

响应字段

返回与 创建 Payout 相同的 payout 对象。

字段	类型	说明
payout_uuid	string	payout 内部标识符
external_id	string	provider 的 payout id
status	string	当前状态（pending、issued、realized、returned、canceled、error、expired）
type_payout	string	使用的通道
amount	number (float)	payout 金额
fee	number (float)	provider 费用
currency	string	ISO 4217 货币
description	string	payout 描述
beneficiary_name	string	受益人姓名
transaction_reference	string	使用的幂等键
submitted_date	string	发送至 provider 的日期
confirmed_date	string	确认日期
payment_code	string	现金提取码（仅现金 payout）
authorization_code	string	provider 授权码（如可用）
destination	object	目标数据回显
message	array	provider/处理消息
created	string	创建时间戳（ISO 8601）
updated	string	最后更新时间戳（ISO 8601）

---

错误响应

状态码	代码	说明
401	unauthorized	Bearer 令牌无效或过期
404	errors.wallet.not_found	钱包未找到
404	errors.wallet.payout_not_found	payout 未找到，或不属于该钱包

---

代码示例

cURL

curl -s "https://sandbox.api.a55.tech/api/v1/bank/wallet/payout/9b1f0c88-3a3c-4f2f-9d6e-1f0a2d4e88c1/f47ac10b-58cc-4372-a567-0e02b2c3d479/" \
  -H "Authorization: Bearer $A55_ACCESS_TOKEN"

Python

import requests
import os

token = os.environ["A55_ACCESS_TOKEN"]
base = os.environ.get("A55_API_URL", "https://sandbox.api.a55.tech")

payout_uuid = "9b1f0c88-3a3c-4f2f-9d6e-1f0a2d4e88c1"
wallet_uuid = "f47ac10b-58cc-4372-a567-0e02b2c3d479"

payout = requests.get(
    f"{base}/api/v1/bank/wallet/payout/{payout_uuid}/{wallet_uuid}/",
    headers={"Authorization": f"Bearer {token}"},
).json()

print(f"Payout {payout['payout_uuid']} — 状态: {payout['status']}")

Node.js

const token = process.env.A55_ACCESS_TOKEN;
const base = process.env.A55_API_URL || "https://sandbox.api.a55.tech";

const payoutUuid = "9b1f0c88-3a3c-4f2f-9d6e-1f0a2d4e88c1";
const walletUuid = "f47ac10b-58cc-4372-a567-0e02b2c3d479";

const payout = await fetch(
  `${base}/api/v1/bank/wallet/payout/${payoutUuid}/${walletUuid}/`,
  { headers: { Authorization: `Bearer ${token}` } }
).then((r) => r.json());

console.log(`Payout ${payout.payout_uuid} — 状态: ${payout.status}`);

---

创建 payout →从钱包发起新的付款。Payout 列表 →列出并筛选钱包的 payout。Payout Webhook →在 payout 状态变更时接收通知。