Payout 列表

Quick Reference

What列出钱包的 payout

Why对账并监控付款，支持筛选和分页

Reading Time3 分钟

DifficultyBeginner

Prerequisites身份验证 → 一个 wallet_uuid

GET/api/v1/bank/wallet/payout/Bearer Token列出钱包的 payout

返回由钱包提供资金的 payout 的分页列表。支持 MagicQuery 筛选和排序表达式。

---

查询参数

参数	类型	必填	默认值	说明
wallet_uuid	string (UUID)	是	—	要列出 payout 的钱包
page	integer	否	1	页码
limit	integer	否	10	每页条数
filter	string	否	—	MagicQuery 筛选表达式（如 status:eq:realized）
sort	string	否	—	MagicQuery 排序表达式（如 created:desc）

请求头

Header	值	必填
Authorization	Bearer {A55_ACCESS_TOKEN}	是

---

响应字段

字段	类型	说明
page	integer	当前页
limit	integer	每页条数
total	integer	payout 总数
pages	integer	总页数
data	array	payout 对象列表（与 查询 Payout 结构相同）

---

错误响应

状态码	代码	说明
401	unauthorized	Bearer 令牌无效或过期
404	errors.wallet.not_found	钱包未找到

---

代码示例

cURL

curl -s "https://sandbox.api.a55.tech/api/v1/bank/wallet/payout/?wallet_uuid=f47ac10b-58cc-4372-a567-0e02b2c3d479&filter=status:eq:realized&sort=created:desc&page=1&limit=20" \
  -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")

result = requests.get(
    f"{base}/api/v1/bank/wallet/payout/",
    params={
        "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "filter": "status:eq:realized",
        "sort": "created:desc",
        "page": 1,
        "limit": 20,
    },
    headers={"Authorization": f"Bearer {token}"},
).json()

print(f"{result['total']} 个 payout，共 {result['pages']} 页")

Node.js

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

const params = new URLSearchParams({
  wallet_uuid: "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  filter: "status:eq:realized",
  sort: "created:desc",
  page: "1",
  limit: "20",
});

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

console.log(`${result.total} 个 payout，共 ${result.pages} 页`);

---

响应示例

{
  "page": 1,
  "limit": 20,
  "total": 2,
  "pages": 1,
  "data": [
    {
      "payout_uuid": "9b1f0c88-3a3c-4f2f-9d6e-1f0a2d4e88c1",
      "status": "realized",
      "type_payout": "pix",
      "amount": 100.00,
      "currency": "BRL",
      "beneficiary_name": "João Silva",
      "transaction_reference": "PAY-2048",
      "created": "2026-06-16T18:00:00Z"
    },
    {
      "payout_uuid": "5c2a13f0-5e74-4b21-9c6a-2bd9d9b0aa10",
      "status": "issued",
      "type_payout": "cash_pickup",
      "amount": 200.00,
      "currency": "USD",
      "beneficiary_name": "Pedro",
      "transaction_reference": "PAY-2052",
      "created": "2026-06-16T18:05:00Z"
    }
  ]
}

---

创建 payout →从钱包发起新的付款。查询 payout →通过 id 查询单个 payout。Payout Webhook →在 payout 状态变更时接收通知。