跳至主要內容

國際匯款（CN入境）

Easylink2026/3/31大約 15 分鐘

概述

本文檔匯總 匯款（remit） 與 轉帳（transfer） 相關開放介面（含 MEPay 等通道），包括請求說明、參數表與請求／回應範例。通用約定：POST 請求、application/json 或 application/x-www-form-urlencoded；簽名字段見接入規則。

汇款充值

商户通过该接口进行汇款充值提交，系统会调用对应转账通道处理充值请求。

接口说明

请求URL：/api/remit/recharge

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名变量名必填类型描述
商户号mchNo是String商户号
应用IDappId是String商户应用ID
支付接口代码ifCode是String转账通道代码
凭证号voucherNo是String充值凭证号
银行账号accountNo是String充值来源账号
充值币种currency是String充值币种
充值金额amount是Long金额（分），最小值1
附件attachment否String附件地址或标识
文件Base64流fileBase64Str否String文件Base64内容
文件名fileName否String上传文件名
付款银行名称payerBankName否String付款银行
商户名称mchName否String商户名称
请求时间reqTime是String13位时间戳
接口版本version是String固定为1.0
签名sign是String签名值
签名类型signType是String签名类型（如MD5）

请求示例数据

{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "MEPay",
  "voucherNo": "VR202603310001",
  "accountNo": "6222021234567890123",
  "currency": "HKD",
  "amount": 100000,
  "attachment": "",
  "fileBase64Str": "",
  "fileName": "",
  "payerBankName": "示例银行",
  "mchName": "示例商户",
  "reqTime": "1711850400000",
  "version": "1.0",
  "signType": "MD5",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

返回参数

字段名变量名必填类型描述
返回状态code是Integer0表示成功，其他为失败
返回信息msg否String错误描述
签名信息sign否String对data签名
返回数据data否Object业务返回数据（本接口无固定字段）

返回示例数据（成功）

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {},
  "sign": "F4DA202C516D1F33A12F1E547C5004FD"
}

返回示例数据（失败，code 为 9999 表示业务失败）

{
  "code": 9999,
  "msg": "应用未开通此接口配置!",
  "data": null,
  "sign": null
}

查询汇款汇率

商户查询汇款汇率信息，返回可用汇率列表（含部分通道扩展字段）。

接口说明

请求URL：/api/remit/queryExRate

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名变量名必填类型描述
商户号mchNo是String商户号
应用IDappId是String商户应用ID
支付接口代码ifCode是String转账通道代码
源币种sourceCurrency否String源币种（MEPay渠道）
目标币种targetCurrency否String目标币种（MEPay渠道）
目标金额targetAmount否BigDecimal目标金额（MEPay渠道）
请求时间reqTime是String13位时间戳
接口版本version是String固定为1.0
签名sign是String签名值
签名类型signType是String签名类型

请求示例数据

{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "MEPay",
  "sourceCurrency": "HKD",
  "targetCurrency": "CNY",
  "targetAmount": 1000.00,
  "reqTime": "1711850400000",
  "version": "1.0",
  "signType": "MD5",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

返回参数

字段名变量名必填类型描述
返回状态code是Integer0表示成功，其他为失败
返回信息msg否String错误描述
签名信息sign否String对data签名
返回数据data否Object业务返回对象

data.list字段

字段名变量名类型描述
源币种sourceString汇率源币种
目标币种targetString汇率目标币种
汇率rateBigDecimal兑换汇率
报价IDquoteIdString汇率报价ID（预下单可用）
目标金额targetAmountBigDecimal汇率目标金额
源金额sourceAmountBigDecimal汇率源金额（不含手续费）
过期时间expireTimeLocalDateTime汇率过期时间

返回示例数据（成功）

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "list": [
      {
        "source": "HKD",
        "target": "CNY",
        "rate": 0.92,
        "quoteId": "QUOTE202603310001",
        "targetAmount": 1000.00,
        "sourceAmount": 1086.96,
        "expireTime": "2026-03-31T12:00:00"
      }
    ]
  },
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

返回示例数据（失败）

{
  "code": 9999,
  "msg": "获取商户应用信息失败",
  "data": null,
  "sign": null
}

查询汇款限额

商户查询当前汇款业务可用限额信息。

接口说明

请求URL：/api/remit/limit

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名变量名必填类型描述
商户号mchNo是String商户号
应用IDappId是String商户应用ID
支付接口代码ifCode是String转账通道代码
请求时间reqTime是String13位时间戳
接口版本version是String固定为1.0
签名sign是String签名值
签名类型signType是String签名类型

请求示例数据

{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "MEPay",
  "reqTime": "1711850400000",
  "version": "1.0",
  "signType": "MD5",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

返回参数

字段名变量名必填类型描述
返回状态code是Integer0表示成功，其他为失败
返回信息msg否String错误描述
签名信息sign否String对data签名
返回数据data否Object业务返回对象

data.list字段

字段名变量名类型描述
币种currencyString限额币种
单笔限额singleTransactionLimitBigDecimal单笔最大金额
日限额dailyLimitBigDecimal当日累计限额
年限额annualLimitBigDecimal年累计限额

返回示例数据（成功）

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "list": [
      {
        "currency": "HKD",
        "singleTransactionLimit": 500000.00,
        "dailyLimit": 2000000.00,
        "annualLimit": 50000000.00
      }
    ]
  },
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

返回示例数据（失败）

{
  "code": 9999,
  "msg": "应用未开通此接口配置!",
  "data": null,
  "sign": null
}

查询汇款账户

商户查询汇款账户余额信息。

接口说明

请求URL：/api/remit/account

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名变量名必填类型描述
商户号mchNo是String商户号
应用IDappId是String商户应用ID
支付接口代码ifCode是String转账通道代码
请求时间reqTime是String13位时间戳
接口版本version是String固定为1.0
签名sign是String签名值
签名类型signType是String签名类型

请求示例数据

{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "MEPay",
  "reqTime": "1711850400000",
  "version": "1.0",
  "signType": "MD5",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

返回参数

字段名变量名必填类型描述
返回状态code是Integer0表示成功，其他为失败
返回信息msg否String错误描述
签名信息sign否String对data签名
返回数据data否Object业务返回对象

data.list字段

字段名变量名类型描述
币种currencyString账户币种
余额balanceString账户可用余额
冻结余额frozenBalanceString冻结金额
待支付余额pendingBalanceString待支付金额
授信额度creditLimitString授信总额度
授信余额creditBalanceString授信剩余额度
账户号accountNoLong账户编号
账户名称accountNameString账户名称

返回示例数据（成功）

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "list": [
      {
        "currency": "HKD",
        "balance": "100000.00",
        "frozenBalance": "0.00",
        "pendingBalance": "500.00",
        "creditLimit": "0.00",
        "creditBalance": "0.00",
        "accountNo": 10086001,
        "accountName": "示例汇款账户"
      }
    ]
  },
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

返回示例数据（失败）

{
  "code": 9999,
  "msg": "无此转账通道接口",
  "data": null,
  "sign": null
}

查询汇款账户明细

商户按分页条件查询汇款账户流水明细。

接口说明

请求URL：/api/remit/account/list

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名变量名必填类型描述
商户号mchNo是String商户号
应用IDappId是String商户应用ID
支付接口代码ifCode是String转账通道代码
每页条数pageSize是Integer分页大小
页码pageNumber是Integer当前页（从1开始）
开始日期startDate否String查询开始日期
结束日期endDate否String查询结束日期
账号accountNo否Long账户号
请求时间reqTime是String13位时间戳
接口版本version是String固定为1.0
签名sign是String签名值
签名类型signType是String签名类型

请求示例数据

{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "MEPay",
  "pageSize": 10,
  "pageNumber": 1,
  "startDate": "2026-03-01",
  "endDate": "2026-03-31",
  "accountNo": 10086001,
  "reqTime": "1711850400000",
  "version": "1.0",
  "signType": "MD5",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

返回参数

字段名变量名必填类型描述
返回状态code是Integer0表示成功，其他为失败
返回信息msg否String错误描述
签名信息sign否String对data签名
返回数据data否Object业务返回对象

data.page.records字段

字段名变量名类型描述
流水号noString账户流水号
币种currencyString币种
变动前额度beforeBalanceString变更前余额
变动后额度afterBalanceString变更后余额
存入金额creditString入账金额
支出金额debitString出账金额
条目名称itemString明细条目
渠道订单号channelOrderNoString渠道侧订单号
类型typeString明细类型
时间dateTimeDate明细时间

返回示例数据（成功，data.page 为 MyBatis-Plus 分页对象序列化结果）

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "page": {
      "records": [
        {
          "no": "DTL202603310001",
          "currency": "HKD",
          "beforeBalance": "100000.00",
          "afterBalance": "99500.00",
          "credit": "0.00",
          "debit": "500.00",
          "item": "转账支出",
          "channelOrderNo": "CH202603310001",
          "type": "DEBIT",
          "dateTime": "2026-03-31T10:30:00.000+00:00"
        }
      ],
      "total": 1,
      "size": 10,
      "current": 1,
      "pages": 1
    }
  },
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

返回示例数据（失败）

{
  "code": 9999,
  "msg": "获取商户应用信息失败",
  "data": null,
  "sign": null
}

创建转账订单

商户发起创建转账单请求，系统完成预校验并调用通道创建转账订单。

接口说明

请求URL：/api/transferOrder

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名变量名必填类型描述
商户号mchNo是String商户号
应用IDappId是String商户应用ID
商户订单号mchOrderNo是String商户侧唯一订单号
支付接口代码ifCode是String转账通道代码
入账方式entryType是String如WX_CASH/ALIPAY_CASH/BANK_CARD
转账金额amount是Long金额（分），最小值1
支付币种payCurrency是String支付币种
目标币种currency是String入账币种
汇率exchangeRate是BigDecimal实际汇率
付款人payer是String付款人信息（JSON字符串）
收款人payee是String收款人信息（JSON字符串）
客户端IPclientIp否String客户端IP
转账用途transferReason是String用途说明
转账备注transferDesc是String备注信息
异步通知地址notifyUrl否String商户通知地址
渠道扩展参数channelExtra否String通道扩展JSON
商户扩展参数extParam否String回传扩展字段
报价IDquoteId否String部分通道汇率报价ID
请求时间reqTime是String13位时间戳
接口版本version是String固定为1.0
签名sign是String签名值
签名类型signType是String签名类型

请求示例数据

{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "mchOrderNo": "mho20260331100001",
  "ifCode": "MEPay",
  "entryType": "BANK_CARD",
  "amount": 10000,
  "payCurrency": "HKD",
  "currency": "HKD",
  "exchangeRate": 1.0,
  "payer": "{\"name\":\"张三\",\"accountNo\":\"6222021234567890123\"}",
  "payee": "{\"name\":\"李四\",\"accountNo\":\"6214851234567890123\",\"bankName\":\"示例银行\"}",
  "clientIp": "192.168.1.100",
  "transferReason": "货款",
  "transferDesc": "2026年3月货款",
  "notifyUrl": "https://www.example.com/notify/transfer",
  "channelExtra": "",
  "extParam": "ref-001",
  "quoteId": "QUOTE202603310001",
  "reqTime": "1711850400000",
  "version": "1.0",
  "signType": "MD5",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

返回参数

字段名变量名必填类型描述
返回状态code是Integer0表示成功，其他为失败
返回信息msg否String错误描述
签名信息sign否String对data签名
返回数据data否Object创建结果数据

data字段

字段名变量名类型描述
转账单号transferIdString平台转账单号
商户订单号mchOrderNoString商户订单号
转账金额amountLong转账金额（分）
收款账号accountNoString收款账号
收款人姓名accountNameString收款人姓名
收款人开户行bankNameString开户行名称
订单状态stateByte订单状态
渠道订单号channelOrderNoString通道订单号
渠道错误码errCodeString渠道错误码
渠道错误描述errMsgString渠道错误信息

返回示例数据（成功）

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "transferId": "T202603311200001",
    "mchOrderNo": "mho20260331100001",
    "amount": 10000,
    "accountNo": "6214851234567890123",
    "accountName": "李四",
    "bankName": "示例银行",
    "state": 1,
    "channelOrderNo": "CH202603311200001",
    "errCode": "",
    "errMsg": ""
  },
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

返回示例数据（失败）

{
  "code": 9999,
  "msg": "商户订单[mho20260331100001]已存在",
  "data": null,
  "sign": null
}

执行转账支付

对已创建并待审核的转账订单发起支付执行。

接口说明

请求URL：/api/transferPay

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名变量名必填类型描述
商户号mchNo是String商户号
应用IDappId是String商户应用ID
支付接口代码ifCode是String转账通道代码
商户转账单号mchOrderNo否String商户侧单号
平台转账单号transferId否String平台转账单号
请求时间reqTime是String13位时间戳
接口版本version是String固定为1.0
签名sign是String签名值
签名类型signType是String签名类型

请求示例数据

{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "MEPay",
  "mchOrderNo": "mho20260331100001",
  "transferId": "T202603311200001",
  "reqTime": "1711850400000",
  "version": "1.0",
  "signType": "MD5",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

返回参数

字段名变量名必填类型描述
返回状态code是Integer0表示成功，其他为失败
返回信息msg否String错误描述
签名信息sign否String对data签名
返回数据data否Object业务返回数据（无固定字段）

返回示例数据（成功，响应体中 channelRetMsg 不参与 JSON 序列化，故 data 一般为空对象）

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {},
  "sign": "F4DA202C516D1F33A12F1E547C5004FD"
}

返回示例数据（失败）

{
  "code": 9999,
  "msg": "订单不存在",
  "data": null,
  "sign": null
}

拒绝转账

对待审核转账订单进行拒绝操作。

接口说明

请求URL：/api/transferReject

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名变量名必填类型描述
商户号mchNo是String商户号
应用IDappId是String商户应用ID
支付接口代码ifCode是String转账通道代码
商户转账单号mchOrderNo否String商户侧单号
平台转账单号transferId否String平台转账单号
拒绝原因remark否String拒绝备注
请求时间reqTime是String13位时间戳
接口版本version是String固定为1.0
签名sign是String签名值
签名类型signType是String签名类型

请求示例数据

{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "MEPay",
  "mchOrderNo": "mho20260331100001",
  "transferId": "T202603311200001",
  "remark": "商户主动取消",
  "reqTime": "1711850400000",
  "version": "1.0",
  "signType": "MD5",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

返回参数

字段名变量名必填类型描述
返回状态code是Integer0表示成功，其他为失败
返回信息msg否String错误描述
签名信息sign否String对data签名
返回数据data否Object业务返回数据（无固定字段）

返回示例数据（成功，channelRetMsg 不参与 JSON 序列化时 data 可能为空对象）

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {},
  "sign": "F4DA202C516D1F33A12F1E547C5004FD"
}

返回示例数据（失败）

{
  "code": 9999,
  "msg": "订单状态异常",
  "data": null,
  "sign": null
}

查询转账订单

商户根据商户订单号或平台转账单号查询订单状态。

接口说明

请求URL：/api/transfer/query

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

字段名变量名必填类型描述
商户号mchNo是String商户号
应用IDappId是String商户应用ID
商户转账单号mchOrderNo否String与transferId二选一
平台转账单号transferId否String与mchOrderNo二选一
请求时间reqTime是String13位时间戳
接口版本version是String固定为1.0
签名sign是String签名值
签名类型signType是String签名类型

请求示例数据

{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "mchOrderNo": "mho20260331100001",
  "transferId": "",
  "reqTime": "1711850400000",
  "version": "1.0",
  "signType": "MD5",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

返回参数

字段名变量名必填类型描述
返回状态code是Integer0表示成功，其他为失败
返回信息msg否String错误描述
签名信息sign否String对data签名
返回数据data否Object订单信息

data字段

字段名变量名类型描述
转账订单号transferIdString平台转账订单号
商户号mchNoString商户号
应用IDappIdString应用ID
商户订单号mchOrderNoString商户订单号
支付接口代码ifCodeString转账通道代码
入账方式entryTypeString入账方式
转账金额amountLong金额（分）
币种currencyString三位货币代码
收款账号accountNoString收款账号
收款人姓名accountNameString收款人姓名
收款开户行bankNameString开户行名称
转账备注transferDescString转账备注
订单状态stateByte0-订单生成,1-复核中,2-转账中,3-转账成功,4-转账失败,5-订单关闭,6-下单处理中
渠道扩展参数channelExtraString通道扩展参数
渠道订单号channelOrderNoString渠道订单号
渠道错误码errCodeString渠道错误码
渠道错误描述errMsgString渠道错误描述
商户扩展参数extParamString商户透传参数
成功时间successTimeLong13位时间戳
创建时间createdAtLong13位时间戳

返回示例数据（成功）

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "transferId": "T202603311200001",
    "mchNo": "M1623984572",
    "appId": "60cc09bce4b0f1c0b83761c9",
    "mchOrderNo": "mho20260331100001",
    "ifCode": "MEPay",
    "entryType": "BANK_CARD",
    "amount": 10000,
    "currency": "HKD",
    "accountNo": "6214851234567890123",
    "accountName": "李四",
    "bankName": "示例银行",
    "transferDesc": "2026年3月货款",
    "state": 3,
    "channelExtra": "",
    "channelOrderNo": "CH202603311200001",
    "errCode": "",
    "errMsg": "",
    "extParam": "ref-001",
    "successTime": 1711850500000,
    "createdAt": 1711850400000
  },
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

返回示例数据（失败）

{
  "code": 9999,
  "msg": "订单不存在",
  "data": null,
  "sign": null
}

转账异步通知

该接口为支付通道回调入口，由通道侧调用，平台据此更新转账订单状态并触发商户通知。

接口说明

请求URL：

  • /api/transfer/notify/{ifCode}
  • /api/transfer/notify/{ifCode}/{transferId}

请求方式：POST（具体通道可能使用GET或POST，以通道规范为准）

请求类型：由通道决定（如application/json、application/x-www-form-urlencoded等）

路径参数

字段名变量名必填类型描述
接口代码ifCode是String通道接口代码
转账单号transferId否String平台转账单号（部分通道放在URL）

说明

  • 该接口为系统内部回调入口，业务请求参数由各通道适配器解析。
  • 回调处理成功后按通道协议返回响应；失败时返回400及错误信息。
  • 订单状态可能更新为：转账成功、转账失败、处理中转待确认等。

请求示例数据（示意：不同通道报文差异很大，以下为 JSON 形式回调的示例）

POST /api/transfer/notify/MEPay/T202603311200001 HTTP/1.1
Content-Type: application/json

{
  "orderId": "CH202603311200001",
  "status": "SUCCESS",
  "amount": "10000",
  "sign": "CHANNEL_SIGN_VALUE"
}

请求示例数据（示意：表单形式回调）

POST /api/transfer/notify/MEPay HTTP/1.1
Content-Type: application/x-www-form-urlencoded

orderId=CH202603311200001&status=SUCCESS&amount=10000&sign=CHANNEL_SIGN_VALUE

响应示例数据（成功：由具体通道实现类决定 HTTP 状态与响应体，以下为常见两种）

HTTP/1.1 200 OK
Content-Type: text/plain

success
HTTP/1.1 200 OK
Content-Type: application/json

{"code":"SUCCESS"}

响应示例数据（失败）

HTTP/1.1 400 Bad Request
Content-Type: text/plain

解析数据异常！
最近更新:
貢獻者: 许博文
默認頁腳
Copyright © 2026 Easylink