支付接口

接口描述：
商户系统 向 支付系统发起转账请求，支付系统在收到请求后,验证处理并返回结果。
这里的 结果 指接口响应结果,非实际转账结果。转账实际处理是异步的。如果商户开启了转账审核，则此时订单状态为待审核，需要再商户后台进一步进行审核。否则为处理中。
转账结果会异步通知到商户的回调地址上(如果有)
业务方向
商户系统 -> 支付系统
安全约束
IP 白名单验证
请求数据签名验证
请求URL：
/api/transferOrder
请求方式：
POST
参数名
必需
 类型
说明
Content-Type 是 string application/json
Accept 是 string application/json
请求参数：
参数名
必需
 类型
数据规格
 说明
merchantNo 是 long 不能为null,最大长度：20 商户号（咨询客服）
merchantOrderNo 是 String 最大长度：32,保障唯一 商户订单号,不可重复
currency 是 int 最大长度：1 币种,1是 CNY 人民币
amount 是 dicimal 最大长度：7 金额,最多支持两位小数
notifyURL 否 String 最大长度：128 异步回调地址,可为nul或空字符串,null时不参与计算签名和验签
wayCode 是 String 最大长度：32 支付方式,请见数据字典表 wayCode
extras 否 String 最大长度：256 扩展参数
timestamp 是 long 最大长度：12 毫秒级时间戳
accountName 是 String 最大长度：64 收款人姓名
accountNo 是 String 最大长度：32 收款人账号
bankName 是 String 最大长度：32 银行名称,仅做展示，不参与业务
transferDesc 是 String 最大长度：64 转账描述
sign 是 String 最大长度：64 签名数据
调用示例：
shell
curl --request POST \
--url https://xxx.com/api/transferOrder  \
--header 'Content-type: application/json' \
--header 'Accept: application/json' \
--data '{
  "merchantNo": 22190316182634496,
  "merchantOrderNo": "b7c573b251c04e84980b0f6b555015c0",
  "currency": 1,
  "notifyURL": "https://baidu.com/api/test/demo/webhook/payment",
  "wayCode": "ALIPAY_CASH",
  "extras": "{}",
  "amount": 100,
  "timestamp": 1767166465403,
  "accountName": "李浩",
  "accountNo": "test123@alipay.com",
  "bankName": "ALIPAY",
  "transferDesc": "测试转账"
}'
json
{
  "merchantNo": 22190316182634496,
  "merchantOrderNo": "b7c573b251c04e84980b0f6b555015c0",
  "currency": 1,
  "notifyURL": "https://baidu.com/api/test/demo/webhook/payment",
  "wayCode": "ALIPAY_CASH",
  "extras": "{}",
  "amount": 100,
  "timestamp": 1767166465403,
  "accountName": "李浩",
  "accountNo": "test123@alipay.com",
  "bankName": "ALIPAY",
  "transferDesc": "测试转账"
}
返回示例：

成功响应时

{
  "data": {
    "merchantNo": 22190316182634496,
    "orderNo": "F22330891309744128",
    "merchantOrderNo": "b7c573b251c04e84980b0f6b555015c0",
    "status": 1,
    "statusMsg": "PROCESSING",
    "timestamp": 1767110426841,
    "sign": "d890a6d360012b36c00b3ecf777fe268"
  },
  "code": "0",
  "message": "Successful"
}

错误时返回

{
  "message": "账户不可用",
  "code": "-1"
}
返回参数说明：
参数名
类型
说明
code String 状态码 ： 字符串0表示成功
msg String 结果描述信息
data Object 结果数据
data 数据结构说明：
参数名
类型
说明
merchantNo long 商户号
orderNo String 支付系统订单号
merchantOrderNo String 商户系统订单号
timestamp long 时间戳
status int 转账订单状态,更多状态请参见数据字典
statusMsg String 状态描述

results matching ""

    No results matching ""