创建收款

Quick Reference

What为任意支付方式创建收款

Why通过单一端点，在 11 种支付方式、7 个国家和 29 个收单机构之间处理支付

Reading Time10 分钟

Difficulty初级

Prerequisites身份验证 → 环境配置

POST/api/v1/bank/wallet/charge/Bearer Token创建新收款

何时使用此端点

场景	创建收款如何帮助您
接受信用卡支付	设置 type_charge: "credit_card" 并提供卡片字段，或让 SDK/结账页面处理
提供 PIX 即时支付	设置 type_charge: "pix"——响应包含二维码和复制粘贴码
生成 Boleto 银行缴费单	设置 type_charge: "boleto"——响应包含条形码和到期日
接受 Apple Pay / Google Pay	设置 type_charge: "applepay" 或 "googlepay" 并传入令牌数据
设置定期扣款	添加 subscription 对象，一次调用同时创建收款和订阅
仅授权流程	设置 capture: false，适用于酒店、租车和预授权场景

---

选择支付方式

选择下方的支付方式。页面将仅显示与该方式相关的字段、代码和响应。

---

请求参数（所有方式）

以下字段对所有支付方式都是必填的：

字段	类型	必填	说明
wallet_uuid	string (UUID（通用唯一标识符）)	是	接收资金的钱包
merchant_id	string	是	商户标识符
payer_name	string	是	付款人全名
payer_email	string	是	付款人邮箱地址
payer_tax_id	string	是	税务 ID（巴西 CPF、墨西哥 RFC、智利 RUT、阿根廷 CUIT）
payer_cell_phone	string	是	付款人手机号（含国际区号）
installment_value	number	是	每期收费金额。对于零小数货币（CLP、COP），使用整数——参见下方货币规则
installment_count	integer	是	分期数（一次性支付使用 1）
currency	string	是	ISO 4217 货币代码：BRL、MXN、CLP、COP、PEN、ARS
due_date	string	是	到期日，格式为 YYYY-MM-DD
description	string	是	向付款人显示的收款描述
type_charge	string	是	支付方式——参见上方选择器
payer_address	object	是	账单地址（详见下方）

付款人地址对象

字段	类型	必填	说明
street	string	是	街道名称
address_number	string	是	门牌号
complement	string	是	公寓、套房、楼层
neighborhood	string	是	社区或区域
city	string	是	城市
state	string	是	州/省代码（如 SP、CDMX）
postal_code	string	是	邮政编码
country	string	否	ISO 3166-1 alpha-2（如 BR）。默认为钱包所在国家

各货币金额规则

货币	小数位	格式	示例	后端行为
BRL	2	150.00	"installment_value": 150.00	存储为 Numeric(11,2)
MXN	2	2500.00	"installment_value": 2500.00	存储为 Numeric(11,2)
USD	2	100.00	"installment_value": 100.00	存储为 Numeric(11,2)
PEN	2	350.00	"installment_value": 350.00	存储为 Numeric(11,2)
ARS	2	85000.00	"installment_value": 85000.00	存储为 Numeric(11,2)
CLP	0	50000	"installment_value": 50000	发送至收单方前截断为整数
COP	0	200000	"installment_value": 200000	发送至收单方前截断为整数

零小数货币

CLP（智利比索）和COP（哥伦比亚比索）没有小数单位。后端在发送至收单方前将金额转换为整数。发送 CLP 50000.50 将得到 50000。这些货币请始终发送整数。

可选字段（所有方式）

字段	类型	默认值	说明
webhook_url	string	——	覆盖此收款的默认 Webhook URL
redirect_url	string	——	结账页面或 3DS 验证后的返回 URL
reference_external_id	string	——	用于对账的内部订单 ID
is_async	boolean	false	在支持的情况下进行异步处理
shipping_address	object	——	收货地址（与 payer_address 结构相同）

---

卡片特定字段

字段	类型	必填	说明
card_number	string	仅 H2H	卡号 PAN（SDK 和结账页面会自动处理）
card_name	string	仅 H2H	卡面印刷姓名
card_expiry_month	string	仅 H2H	到期月份 MM
card_expiry_year	string	仅 H2H	到期年份 YYYY
card_cvv	string	仅 H2H	卡片验证码
capture	boolean	否	true（默认）= 自动捕获；false = 仅授权
threeds_authentication	boolean	否	true 强制 3DS 验证
device_info	object	3DS	3DS 所需的浏览器/设备指纹（详见下方）
antifraud_info	object	否	用于反欺诈评分的行为数据
subscription	object	否	随此收款创建定期订阅

何时需要卡片字段？

• H2H 集成：您直接发送 card_number、card_name、card_expiry_month、card_expiry_year、card_cvv。
• SDK 集成：SDK 在浏览器中收集卡片数据。您只需发送通用字段。
• 结账页面：A55 的托管页面收集所有信息。您只需发送通用字段 + redirect_url。

设备信息对象（3DS）

在 H2H 流程中当 threeds_authentication: true 时必填：

字段	类型	说明
ip_address	string	付款人的 IP 地址
user_agent	string	浏览器 User-Agent 字符串
device_id	string	SDK 生成的设备指纹
session_id	string	发卡行的 DDC 会话 ID
http_accept_content	string	浏览器 Accept 头
http_browser_language	string	浏览器语言（如 en-US）
http_browser_java_enabled	boolean	浏览器是否启用 Java
http_browser_javascript_enabled	boolean	是否启用 JavaScript
http_browser_color_depth	string	颜色深度（如 24）
http_browser_screen_height	string	屏幕高度（像素）
http_browser_screen_width	string	屏幕宽度（像素）
http_browser_time_difference	string	UTC 偏移量（如 -3）

反欺诈信息对象

提升欺诈评分和通过率：

字段	类型	说明
sales_channel	string	web、app、pos、marketplace、link、subscription、api
cardholder_logged_in	boolean	付款人是否已登录
cardholder_since_days	integer	账户创建以来的天数
purchase_history	integer	历史购买总数
days_since_last_purchase_merchant	integer	距上次在您处购买的天数

订阅对象

随此收款创建定期订阅：

字段	类型	必填	说明
cycle	string	是	weekly、biweekly、monthly、quarterly、semiannually、yearly
end_date	string	否	订阅结束日期 YYYY-MM-DD（省略表示无限期）

Apple Pay 字段

字段	类型	必填	说明
applepay.type	string	是	credit_card 或 debit_card
applepay.eci	string	是	Apple Pay 令牌中的电子商务指示符
applepay.cavv	string	是	持卡人认证验证值

Apple Pay 令牌

您的前端通过 Apple Pay JS API 获取 Apple Pay 令牌。从令牌的支付数据中提取 eci 和 cavv 并传入此处。A55 处理其余部分。

Google Pay 字段

字段	类型	必填	说明
googlepay.type	string	是	credit_card 或 debit_card
googlepay.eci	string	否	电子商务指示符
googlepay.cavv	string	否	持卡人认证验证值

Google Pay 令牌

您的前端通过 Google Pay API 获取 Google Pay 令牌。提取密码学数据并传入此处。A55 解密并处理支付。

PIX 特定行为

PIX 在通用参数之外不需要额外字段。设置 type_charge: "pix"，响应将包含：

• pix_qr_code——Base64 编码的二维码图片
• pix_copy_paste——付款人的复制粘贴字符串（EMV 码）
• pix_expiration——二维码过期时间戳

PIX 是即时的

PIX 支付在数秒内确认。您的 Webhook 几乎会立即触发，状态为 status: "paid"。无需捕获步骤。

Boleto 特定行为

Boleto 在通用参数之外不需要额外字段。设置 type_charge: "boleto"，响应将包含：

• boleto_barcode——数字条形码（44 位）
• boleto_url——可打印银行缴费单 PDF 的 URL
• boleto_due_date——付款截止日期

Boleto 结算

Boleto 支付在付款人通过银行、彩票行或银行应用付款后 1-3 个工作日结算。当银行网络确认付款时，您的 Webhook 将触发。

SPEI 特定行为

SPEI 在通用参数之外不需要额外字段。设置 type_charge: "spei" 并将货币设为 MXN。响应将包含 CLABE 号码和参考号，供付款人完成转账。

SPEI 结算

墨西哥的 SPEI 转账通常在银行工作时间内数分钟内结算。A55 监控付款并在确认后发送 Webhook。

OXXO 特定行为

OXXO 在通用参数之外不需要额外字段。设置 type_charge: "oxxo" 并将货币设为 MXN。响应将包含付款参考号和条形码，供付款人在任何 OXXO 便利店出示。

OXXO 结算

OXXO 现金支付在付款人到店付款后 1-2 个工作日结算。参考号在 due_date 到期后失效。

阿根廷 QR 行为

QRA 在通用参数之外不需要额外字段。设置 type_charge: "qra" 并将货币设为 ARS。响应包含二维码，供付款人使用银行应用扫描。

Pago Facil 行为

Pago Facil 在通用参数之外不需要额外字段。设置 type_charge: "pfc" 并将货币设为 ARS。响应包含付款凭证和参考号，供付款人在任何 Pago Facil 网点出示。

电子钱包行为

电子钱包在通用参数之外不需要额外字段。设置 type_charge: "e_wallet"。响应包含重定向 URL 或深层链接，引导付款人前往钱包提供商的应用进行付款授权。

---

代码示例

信用卡收款

cURL

curl -s -X POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "merchant_id": "11111111-1111-1111-1111-111111111111",
    "payer_name": "张伟",
    "payer_email": "zhangwei@example.com",
    "payer_tax_id": "123.456.789-09",
    "payer_cell_phone": "+5511999999999",
    "installment_value": 150.00,
    "installment_count": 3,
    "currency": "BRL",
    "due_date": "2026-12-31",
    "description": "订单 #42——3 期分期",
    "type_charge": "credit_card",
    "card_number": "4024007153763191",
    "card_name": "张伟",
    "card_expiry_month": "12",
    "card_expiry_year": "2030",
    "card_cvv": "123",
    "capture": true,
    "webhook_url": "https://your-app.com/webhooks/a55",
    "payer_address": {
      "street": "Av. Paulista",
      "address_number": "1000",
      "complement": "Sala 101",
      "neighborhood": "Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "postal_code": "01310-100",
      "country": "BR"
    }
  }'

Python

import requests

charge = requests.post(
    "https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
    json={
        "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "merchant_id": "11111111-1111-1111-1111-111111111111",
        "payer_name": "张伟",
        "payer_email": "zhangwei@example.com",
        "payer_tax_id": "123.456.789-09",
        "payer_cell_phone": "+5511999999999",
        "installment_value": 150.00,
        "installment_count": 3,
        "currency": "BRL",
        "due_date": "2026-12-31",
        "description": "订单 #42——3 期分期",
        "type_charge": "credit_card",
        "card_number": "4024007153763191",
        "card_name": "张伟",
        "card_expiry_month": "12",
        "card_expiry_year": "2030",
        "card_cvv": "123",
        "capture": True,
        "webhook_url": "https://your-app.com/webhooks/a55",
        "payer_address": {
            "street": "Av. Paulista",
            "address_number": "1000",
            "complement": "Sala 101",
            "neighborhood": "Bela Vista",
            "city": "São Paulo",
            "state": "SP",
            "postal_code": "01310-100",
            "country": "BR",
        },
    },
    headers={
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json",
    },
).json()

print(f"收款：{charge['charge_uuid']}——状态：{charge['status']}")
print(f"合计：{charge['installment_count']} 期 × R$ {charge['installments'][0]['local_currency']}")

JavaScript

const charge = await fetch(
  "https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      wallet_uuid: "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      merchant_id: "11111111-1111-1111-1111-111111111111",
      payer_name: "张伟",
      payer_email: "zhangwei@example.com",
      payer_tax_id: "123.456.789-09",
      payer_cell_phone: "+5511999999999",
      installment_value: 150.0,
      installment_count: 3,
      currency: "BRL",
      due_date: "2026-12-31",
      description: "订单 #42——3 期分期",
      type_charge: "credit_card",
      card_number: "4024007153763191",
      card_name: "张伟",
      card_expiry_month: "12",
      card_expiry_year: "2030",
      card_cvv: "123",
      capture: true,
      webhook_url: "https://your-app.com/webhooks/a55",
      payer_address: {
        street: "Av. Paulista",
        address_number: "1000",
        complement: "Sala 101",
        neighborhood: "Bela Vista",
        city: "São Paulo",
        state: "SP",
        postal_code: "01310-100",
        country: "BR",
      },
    }),
  }
).then(r => r.json());

console.log(`收款：${charge.charge_uuid}——状态：${charge.status}`);
console.log(`合计：${charge.installment_count} 期 × R$ ${charge.installments[0].local_currency}`);

借记卡收款

cURL

curl -s -X POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "merchant_id": "11111111-1111-1111-1111-111111111111",
    "payer_name": "李明",
    "payer_email": "liming@example.com",
    "payer_tax_id": "987.654.321-00",
    "payer_cell_phone": "+5511988888888",
    "installment_value": 89.90,
    "installment_count": 1,
    "currency": "BRL",
    "due_date": "2026-12-31",
    "description": "订单 #43——借记卡",
    "type_charge": "debit_card",
    "card_number": "5155901222280001",
    "card_name": "李明",
    "card_expiry_month": "06",
    "card_expiry_year": "2029",
    "card_cvv": "456",
    "webhook_url": "https://your-app.com/webhooks/a55",
    "payer_address": {
      "street": "Rua Augusta", "address_number": "500",
      "complement": "Apt 42", "neighborhood": "Consolação",
      "city": "São Paulo", "state": "SP",
      "postal_code": "01304-000", "country": "BR"
    }
  }'

Python

charge = requests.post(
    "https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
    json={
        "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "merchant_id": "11111111-1111-1111-1111-111111111111",
        "payer_name": "李明",
        "payer_email": "liming@example.com",
        "payer_tax_id": "987.654.321-00",
        "payer_cell_phone": "+5511988888888",
        "installment_value": 89.90,
        "installment_count": 1,
        "currency": "BRL",
        "due_date": "2026-12-31",
        "description": "订单 #43——借记卡",
        "type_charge": "debit_card",
        "card_number": "5155901222280001",
        "card_name": "李明",
        "card_expiry_month": "06",
        "card_expiry_year": "2029",
        "card_cvv": "456",
        "webhook_url": "https://your-app.com/webhooks/a55",
        "payer_address": {
            "street": "Rua Augusta", "address_number": "500",
            "complement": "Apt 42", "neighborhood": "Consolação",
            "city": "São Paulo", "state": "SP",
            "postal_code": "01304-000", "country": "BR",
        },
    },
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
).json()
print(f"状态：{charge['status']}")

JavaScript

const charge = await fetch("https://core-manager.a55.tech/api/v1/bank/wallet/charge/", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    wallet_uuid: "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    merchant_id: "11111111-1111-1111-1111-111111111111",
    payer_name: "李明", payer_email: "liming@example.com",
    payer_tax_id: "987.654.321-00", payer_cell_phone: "+5511988888888",
    installment_value: 89.9, installment_count: 1,
    currency: "BRL", due_date: "2026-12-31",
    description: "订单 #43——借记卡", type_charge: "debit_card",
    card_number: "5155901222280001", card_name: "李明",
    card_expiry_month: "06", card_expiry_year: "2029", card_cvv: "456",
    webhook_url: "https://your-app.com/webhooks/a55",
    payer_address: {
      street: "Rua Augusta", address_number: "500", complement: "Apt 42",
      neighborhood: "Consolação", city: "São Paulo", state: "SP",
      postal_code: "01304-000", country: "BR",
    },
  }),
}).then(r => r.json());
console.log(`状态：${charge.status}`);

PIX 收款

cURL

curl -s -X POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "merchant_id": "11111111-1111-1111-1111-111111111111",
    "payer_name": "王芳",
    "payer_email": "wangfang@example.com",
    "payer_tax_id": "111.222.333-44",
    "payer_cell_phone": "+5521977777777",
    "installment_value": 49.90,
    "installment_count": 1,
    "currency": "BRL",
    "due_date": "2026-12-31",
    "description": "订单 #44——PIX",
    "type_charge": "pix",
    "webhook_url": "https://your-app.com/webhooks/a55",
    "payer_address": {
      "street": "Av. Rio Branco", "address_number": "200",
      "complement": "Sala 301", "neighborhood": "Centro",
      "city": "Rio de Janeiro", "state": "RJ",
      "postal_code": "20040-002", "country": "BR"
    }
  }'

Python

charge = requests.post(
    "https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
    json={
        "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "merchant_id": "11111111-1111-1111-1111-111111111111",
        "payer_name": "王芳",
        "payer_email": "wangfang@example.com",
        "payer_tax_id": "111.222.333-44",
        "payer_cell_phone": "+5521977777777",
        "installment_value": 49.90,
        "installment_count": 1,
        "currency": "BRL",
        "due_date": "2026-12-31",
        "description": "订单 #44——PIX",
        "type_charge": "pix",
        "webhook_url": "https://your-app.com/webhooks/a55",
        "payer_address": {
            "street": "Av. Rio Branco", "address_number": "200",
            "complement": "Sala 301", "neighborhood": "Centro",
            "city": "Rio de Janeiro", "state": "RJ",
            "postal_code": "20040-002", "country": "BR",
        },
    },
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
).json()
print(f"PIX 二维码 URL：{charge.get('charge_payment_url')}")
print(f"状态：{charge['status']}")

JavaScript

const charge = await fetch("https://core-manager.a55.tech/api/v1/bank/wallet/charge/", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    wallet_uuid: "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    merchant_id: "11111111-1111-1111-1111-111111111111",
    payer_name: "王芳", payer_email: "wangfang@example.com",
    payer_tax_id: "111.222.333-44", payer_cell_phone: "+5521977777777",
    installment_value: 49.9, installment_count: 1,
    currency: "BRL", due_date: "2026-12-31",
    description: "订单 #44——PIX", type_charge: "pix",
    webhook_url: "https://your-app.com/webhooks/a55",
    payer_address: {
      street: "Av. Rio Branco", address_number: "200", complement: "Sala 301",
      neighborhood: "Centro", city: "Rio de Janeiro", state: "RJ",
      postal_code: "20040-002", country: "BR",
    },
  }),
}).then(r => r.json());
console.log(`PIX 二维码 URL：${charge.charge_payment_url}`);

其他支付方式收款

请求体与通用字段相同。只需更改 type_charge 和 currency 以匹配您的支付方式和国家。

cURL

curl -s -X POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_uuid": "YOUR_WALLET_UUID",
    "merchant_id": "YOUR_MERCHANT_UUID",
    "payer_name": "付款人姓名",
    "payer_email": "payer@example.com",
    "payer_tax_id": "TAX_ID",
    "payer_cell_phone": "+PHONE",
    "installment_value": 100.00,
    "installment_count": 1,
    "currency": "BRL",
    "due_date": "2026-12-31",
    "description": "订单描述",
    "type_charge": "boleto",
    "webhook_url": "https://your-app.com/webhooks/a55",
    "payer_address": {
      "street": "街道", "address_number": "123",
      "complement": "门牌号", "neighborhood": "区",
      "city": "城市", "state": "州",
      "postal_code": "00000-000", "country": "BR"
    }
  }'

Python

charge = requests.post(
    "https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
    json={
        "wallet_uuid": "YOUR_WALLET_UUID",
        "merchant_id": "YOUR_MERCHANT_UUID",
        "payer_name": "付款人姓名",
        "payer_email": "payer@example.com",
        "payer_tax_id": "TAX_ID",
        "payer_cell_phone": "+PHONE",
        "installment_value": 100.00,
        "installment_count": 1,
        "currency": "BRL",
        "due_date": "2026-12-31",
        "description": "订单描述",
        "type_charge": "boleto",  # 可更改为：spei、oxxo、qra、pfc、e_wallet
        "webhook_url": "https://your-app.com/webhooks/a55",
        "payer_address": {
            "street": "街道", "address_number": "123",
            "complement": "门牌号", "neighborhood": "区",
            "city": "城市", "state": "州",
            "postal_code": "00000-000", "country": "BR",
        },
    },
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
).json()

JavaScript

const charge = await fetch("https://core-manager.a55.tech/api/v1/bank/wallet/charge/", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    wallet_uuid: "YOUR_WALLET_UUID",
    merchant_id: "YOUR_MERCHANT_UUID",
    payer_name: "付款人姓名", payer_email: "payer@example.com",
    payer_tax_id: "TAX_ID", payer_cell_phone: "+PHONE",
    installment_value: 100.0, installment_count: 1,
    currency: "BRL", due_date: "2026-12-31",
    description: "订单描述",
    type_charge: "boleto", // 可更改为：spei、oxxo、qra、pfc、e_wallet
    webhook_url: "https://your-app.com/webhooks/a55",
    payer_address: {
      street: "街道", address_number: "123", complement: "门牌号",
      neighborhood: "区", city: "城市", state: "州",
      postal_code: "00000-000", country: "BR",
    },
  }),
}).then(r => r.json());

Apple Pay / Google Pay 收款

cURL

curl -s -X POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "merchant_id": "11111111-1111-1111-1111-111111111111",
    "payer_name": "赵六",
    "payer_email": "zhaoliu@example.com",
    "payer_tax_id": "555.666.777-88",
    "payer_cell_phone": "+5511966666666",
    "installment_value": 299.00,
    "installment_count": 1,
    "currency": "BRL",
    "due_date": "2026-12-31",
    "description": "订单 #45——Apple Pay",
    "type_charge": "applepay",
    "applepay": {
      "type": "credit_card",
      "eci": "05",
      "cavv": "AAABBJg0VhI0VniQEjRWAAAAAAA="
    },
    "webhook_url": "https://your-app.com/webhooks/a55",
    "payer_address": {
      "street": "Av. Faria Lima", "address_number": "3000",
      "complement": "18 andar", "neighborhood": "Itaim Bibi",
      "city": "São Paulo", "state": "SP",
      "postal_code": "04538-132", "country": "BR"
    }
  }'

Python

charge = requests.post(
    "https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
    json={
        "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "merchant_id": "11111111-1111-1111-1111-111111111111",
        "payer_name": "赵六",
        "payer_email": "zhaoliu@example.com",
        "payer_tax_id": "555.666.777-88",
        "payer_cell_phone": "+5511966666666",
        "installment_value": 299.00,
        "installment_count": 1,
        "currency": "BRL",
        "due_date": "2026-12-31",
        "description": "订单 #45——Apple Pay",
        "type_charge": "applepay",
        "applepay": {"type": "credit_card", "eci": "05", "cavv": "AAABBJg0VhI0VniQEjRWAAAAAAA="},
        "webhook_url": "https://your-app.com/webhooks/a55",
        "payer_address": {
            "street": "Av. Faria Lima", "address_number": "3000",
            "complement": "18 andar", "neighborhood": "Itaim Bibi",
            "city": "São Paulo", "state": "SP",
            "postal_code": "04538-132", "country": "BR",
        },
    },
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
).json()

JavaScript

const charge = await fetch("https://core-manager.a55.tech/api/v1/bank/wallet/charge/", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    wallet_uuid: "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    merchant_id: "11111111-1111-1111-1111-111111111111",
    payer_name: "赵六", payer_email: "zhaoliu@example.com",
    payer_tax_id: "555.666.777-88", payer_cell_phone: "+5511966666666",
    installment_value: 299.0, installment_count: 1,
    currency: "BRL", due_date: "2026-12-31",
    description: "订单 #45——Apple Pay", type_charge: "applepay",
    applepay: { type: "credit_card", eci: "05", cavv: "AAABBJg0VhI0VniQEjRWAAAAAAA=" },
    webhook_url: "https://your-app.com/webhooks/a55",
    payer_address: {
      street: "Av. Faria Lima", address_number: "3000", complement: "18 andar",
      neighborhood: "Itaim Bibi", city: "São Paulo", state: "SP",
      postal_code: "04538-132", country: "BR",
    },
  }),
}).then(r => r.json());

---

响应

收款生命周期

响应字段

字段	类型	说明
charge_uuid	string	收款唯一标识符
status	string	issued、pending、confirmed、paid、error、canceled、refunded
local_currency	number	钱包结算币种的金额
currency	string	ISO 4217 货币代码
usd_currency	number	等值美元金额
eur_currency	number	等值欧元金额
type	string	使用的支付方式
date	string	收款创建日期
description	string	收款描述
due_date	string	付款到期日
installment_count	integer	分期数
installments	array	每期分期明细
charge_payment_url	string	结账/SDK 支付 URL（适用时）
url_3ds	string	3DS 验证重定向 URL（仅 H2H）
message	array/null	status: "error" 时的错误详情
subscription	object	订阅详情（当包含 subscription 时）

卡片响应示例

{
  "charge_uuid": "51dcca6e-7310-4b73-a94c-90835408f2ff",
  "local_currency": 150.00,
  "currency": "BRL",
  "usd_currency": 26.90,
  "eur_currency": 23.58,
  "type": "credit_card",
  "date": "2026-03-20",
  "description": "订单 #42——3 期分期",
  "due_date": "2026-12-31",
  "status": "confirmed",
  "message": null,
  "installment_count": 3,
  "installments": [
    {
      "local_currency": 50.00,
      "currency": "BRL",
      "usd_currency": 8.97,
      "eur_currency": 7.86,
      "due_date": "2026-12-31",
      "status": "confirmed",
      "installment_number": 1
    },
    {
      "local_currency": 50.00,
      "currency": "BRL",
      "usd_currency": 8.97,
      "eur_currency": 7.86,
      "due_date": "2027-01-31",
      "status": "confirmed",
      "installment_number": 2
    },
    {
      "local_currency": 50.00,
      "currency": "BRL",
      "usd_currency": 8.97,
      "eur_currency": 7.86,
      "due_date": "2027-02-28",
      "status": "confirmed",
      "installment_number": 3
    }
  ]
}

PIX 响应示例

{
  "charge_uuid": "51dcca6e-7310-4b73-a94c-90835408f2ff",
  "local_currency": 49.90,
  "currency": "BRL",
  "usd_currency": 8.95,
  "eur_currency": 7.85,
  "type": "pix",
  "date": "2026-03-20",
  "description": "订单 #44——PIX",
  "due_date": "2026-12-31",
  "status": "issued",
  "installment_count": 1,
  "installments": [
    {
      "local_currency": 49.90,
      "currency": "BRL",
      "due_date": "2026-12-31",
      "status": "issued",
      "installment_number": 1
    }
  ],
  "charge_payment_url": "https://pay.a55.tech/charge/51dcca6e-7310-4b73-a94c-90835408f2ff"
}

响应示例

{
  "charge_uuid": "51dcca6e-7310-4b73-a94c-90835408f2ff",
  "local_currency": 100.00,
  "currency": "BRL",
  "usd_currency": 17.93,
  "eur_currency": 15.72,
  "type": "boleto",
  "date": "2026-03-20",
  "description": "订单描述",
  "due_date": "2026-12-31",
  "status": "issued",
  "installment_count": 1,
  "installments": [
    {
      "local_currency": 100.00,
      "currency": "BRL",
      "due_date": "2026-12-31",
      "status": "issued",
      "installment_number": 1
    }
  ],
  "charge_payment_url": "https://pay.a55.tech/charge/51dcca6e-7310-4b73-a94c-90835408f2ff"
}

错误响应

{
  "charge_uuid": "51dcca6e-7310-4b73-a94c-90835408f2ff",
  "status": "error",
  "message": [
    {
      "code": "error_threeds_authentication",
      "source": "authentication",
      "description": "Issuing bank declined the authentication"
    }
  ]
}

---

错误代码

代码	含义	处理方式
INVALID_TYPE_CHARGE	不支持的 type_charge 值	检查上方选择器中的允许值
errors.wallet.not_found	钱包 UUID 不存在	验证 wallet_uuid
errors.unexpected	内部服务器错误	使用指数退避重试；若持续出现请联系支持
error_threeds_authentication	3DS 验证失败	要求付款人重试或使用其他卡片

务必使用 Webhook

切勿仅依赖同步响应来判断最终支付状态。收款可能会异步经过多个状态。设置 webhook_url 并将 Webhook 视为真实数据来源。

查询收款 →通过 UUID 轮询收款状态。捕获收款 →捕获之前授权的卡片支付。Webhook 概述 →接收实时状态更新。