跳转到主要内容
  • 支持向全球 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 配置计算。
  1. 查询支付方式并创建 CARD 受益人。
  2. 使用已保存的 beneficiary_id、currency、amount 和 fee_paid_by 调用出款预检,检查余额与受益人校验结果。预检不预留资金,也不保证创建成功。
  3. 使用该 beneficiary_id 创建出款。也可在 beneficiary 中提供完整卡受益人对象并省略 beneficiary_id;卡字段位于 beneficiary.bank_details。两种方式使用相同受益人校验规则。
  4. 保存 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。 参见出款实测示例。