跨境收付 API 开放平台介绍

flowchart TD classDef actor fill:#fff2cc,stroke:#d6b656,stroke-width:2px,color:#000 classDef partner fill:#dae8fc,stroke:#6c8ebf,stroke-width:2px,color:#000 classDef gw fill:#d5e8d4,stroke:#82b366,stroke-width:2px,color:#000 M([终端商户]):::actor subgraph 平台["合作平台网站（软件服务商 / 企业系统）"] direction TB UI[商户操作界面
合作平台原生体验]:::partner SDK[开放接口对接
对商户透明]:::partner end GW{{开放接口网关
统一入口 · 按业务方法路由}}:::gw FUND[资金通道
平台内部路由层分发]:::partner M ==>|全程操作| UI UI --> SDK SDK ==>|调用开放接口| GW GW ==>|路由到内部服务| FUND

swimlane-beta LR subgraph 商户[" 🟡 终端商户 "] M1(["在合作平台完成入网/报备/开户"]) end subgraph 平台[" 🔵 合作平台网站 "] P1["入网/报备/开户申请"] P2["查询结果"] end subgraph 网关[" 🟢 开放接口网关 "] G1["路由到内部服务"] G2["受理 + 返回结果"] end subgraph 通道[" 🔴 资金通道 "] C1["受理入网报备"] end M1 --> P1 --> G1 --> C1 --> G2 --> P2

swimlane-beta LR subgraph 商户[" 🟡 终端商户 "] MS(["感知来账到账"]) end subgraph 平台[" 🔵 合作平台网站 "] P3["收到来账通知·商户感知"] P4["新建/更新合同订单"] P5["关联合同·资金解锁"] end subgraph 网关[" 🟢 开放接口网关 "] G3["推送来账通知
（初始→中间→终态）"] G4["合同审核路由"] end subgraph 通道[" 🔴 资金通道 "] C2["海外买家付款到账"] C3["合同审核 + 资金解锁"] end C2 --> G3 --> P3 --> MS P3 --> P4 --> G4 --> C3 --> P5

swimlane-beta LR subgraph 商户[" 🟡 终端商户 "] M2(["选择付款/换汇场景"]) end subgraph 平台[" 🔵 合作平台网站 "] P6["付款-请求 / 换汇-请求"] P7["主动查询（轮询）"] end subgraph 网关[" 🟢 开放接口网关 "] G5["资金路由"] G6["返回最终态"] end subgraph 通道[" 🔴 资金通道 "] C4["付款/换汇处理"] end M2 --> P6 --> G5 --> C4 --> G6 --> P7

swimlane-beta LR subgraph 商户[" 🟡 终端商户 "] M3(["退款窗口内发起"]) end subgraph 平台[" 🔵 合作平台网站 "] P8["发起退款 / 退款查询"] P9["余额查询 / 文件上传下载"] end subgraph 网关[" 🟢 开放接口网关 "] G7["退款路由"] G8["基础服务路由"] end subgraph 通道[" 🔴 资金通道 "] C5["退款处理"] end M3 --> P8 --> G7 --> C5 P9 --> G8

flowchart TD classDef merchant fill:#fff2cc,stroke:#d6b656,stroke-width:2px,color:#000 classDef platform fill:#dae8fc,stroke:#6c8ebf,stroke-width:2px,color:#000 classDef gateway fill:#d5e8d4,stroke:#82b366,stroke-width:2px,color:#000 classDef webhook fill:#e1d5e7,stroke:#9673a6,stroke-width:2px,color:#000,stroke-dasharray: 5 5 Start([商户在合作平台网站操作]):::merchant subgraph P0[主体准备 · 一期] direction TB P0a[商户入网/企业报备/收款账户申请]:::platform end subgraph P1[收款域 · 一期 · 来账两种类型并行处理] direction TB A1[来账通知 全过程推送]:::webhook A2[同名充值来账]:::platform A3[充值补充资料 入账]:::platform A4[贸易来账]:::platform A5[新建/更新合同订单]:::platform A6[关联合同 资金解锁]:::gateway A7[关联状态查询]:::platform A1-->A2-->A3 A1-->A4-->A5-->A6-->A7 end subgraph P2[交易域 · 一期 · 付款/换汇/退款 · 商户发起] direction TB B0[商户发起收款人报备]:::merchant B0a[收款人报备结果查询]:::platform B1{商户选择资金运用场景}:::merchant B2[结汇给自己
外币结汇成人民币付给自己账户]:::platform B3[结汇给供应商
外币结汇成人民币付给境内供应商]:::platform B4[外币付自己
保留原币付给自己境外账户]:::platform B5[外币付供应商
保留原币付给境外供应商]:::platform B6[付款-请求 / 换汇-请求]:::gateway B7[商户发起退款 窗口内]:::merchant B8[退款查询]:::platform B9[查询获取结果]:::platform B0-->B0a B0a-->B1 B1-->|结汇|B2 B1-->|结汇|B3 B1-->|外币|B4 B1-->|外币|B5 B1-->|退款|B7 B5-->B6 B2-->B6 B3-->B6 B4-->B6 B7-->B8 B6-->B9 B8-->B9 end subgraph P4[基础服务 · 一期 · 独立 随时调用] direction TB D1[余额查询 按商编]:::platform D2[文件上传/下载]:::platform end Start-->P0-->P1-->P2 P4-.独立基础服务 不依赖流程.->P2 L1["图例：🟨 商户发起 · 🟦 平台能力 · 🟩 网关 · 🟪 来账推送（唯一推送）"]:::legend classDef legend fill:#fff,stroke:#999,stroke-dasharray:3 3,color:#333 class L1 legend

sequenceDiagram participant P as 合作平台（含终端商户） participant G as 开放接口网关 participant U as 资金通道（平台内部路由） Note over P,U: 场景一：申请类业务（付款/换汇/退款/合同/报备）— 一期不推送回调，对接方主动查询 P->>G: ① 提交业务申请 G-->>P: 受理成功（状态=已受理 ≠ 业务成功） Note over P: 展示「处理中…」 G->>U: ② 异步调上游处理 P->>G: ③ 主动查询（首次） G-->>P: 返回「处理中」（未到终态） Note over P: 继续轮询查询… P->>G: ③ 主动查询（再次） G-->>P: 返回最终态（成功/失败） Note over P: 展示「成功」或「失败原因」 Note over P,U: 场景二：来账通知 — 一期唯一推送，全过程（初始态→中间态→终态） U->>G: 海外买家付款到账（来账发生） G->>P: 推送来账通知（初始态） Note over G,P: 全过程推送：初始态→中间态→终态
来账是被动入账，商户需全程感知 G->>P: 推送来账通知（中间态变化） G->>P: 推送来账通知（终态：入账完成）