- 支持向全球 180 多个国家和地区、30 多种币种出款,包括向中国大陆出款 CNY。
- 你可以使用自己的实体作为付款人,也可以代表子账户发起出款(POBO,代付)。详见:COBO & POBO
- 你可以在发起出款之前预先创建收款方(受益人),以简化和加速整个出款流程。
支持的国家/地区和币种
- 请参阅支持的国家/地区和币种
出款状态流程图
⚠️ 注意:Completed 状态并非终态,后续仍可能被更新为 Failed。
出款时序图
⚠️ 注意:Completed 状态并非终态,后续仍可能被更新为 Failed。
API 文档
集成说明:
- Create Payout 需要
x-idempotency-key;仅在同一笔出款发生客户端超时或不确定失败后重试时复用同一个 key。 - 对于 POBO 出款,请在
x-on-behalf-of请求头中传入子账户account_id。 - 你可以使用已有的
beneficiary_id创建出款,也可以在请求中提供完整beneficiary信息。不要在同一个请求中同时传入两者。 - 创建出款前,可使用 List Balances 或 Retrieve Balance 确认源账户有足够可用余额。出款处理后,如需核对余额变动,可使用 List Balances Transactions。
- 对于跨币种出款,请先创建报价,并在出款请求中传入返回的
quote_id。
Mastercard Send 出款
调用前须开通 Mastercard 出款产品及对应的付款方/收款方授权。支持公司到公司、公司到个人、个人到个人,不支持个人到公司。付款币不是 USD 时还须开通跨币出款产品,即使收款币与付款币相同;手续费按 Mastercard 配置计算。- 查询支付方式并创建 CARD 受益人。
- 使用已保存的
beneficiary_id、currency、amount和fee_paid_by调用出款预检,检查余额与受益人校验结果。预检不预留资金,也不保证创建成功。 - 使用该
beneficiary_id创建出款。也可在beneficiary中提供完整卡受益人对象并省略beneficiary_id;卡字段位于beneficiary.bank_details。两种方式使用相同受益人校验规则。 - 保存
payout_id,查询订单并处理出款通知。READY_TO_SEND响应或payout.ready.send事件仅表示创建,不代表付款完成。
x-idempotency-key。相同请求的幂等重放返回原订单,即使卡片之后过期;新出款仍会重新检查有效期。服务端选择已授权的 Mastercard 渠道,不回退银行转账渠道。不要在出款顶层传 channel_code 或卡资料。
订单响应使用 payout_method: CARD,并在 beneficiary.bank_details.card_expiry 保留创建订单时的卡有效期快照。Webhook 使用 data.payment_type: CARD。
参见出款实测示例。
