# 1 静态VA创建接口

# 简要描述

  • 商户代付-静态VA接口

# HTTP请求信息

# 请求URL

  • {domain}/open-api/static/payment/code

# 请求方式

  • POST

# 请求头

参数名 必选 类型 说明
Content-Type mandatory string application/json

# 请求体参数

参数名 必选 类型 长度限制 示例 说明
appId string - - 应用APPID
param string - - 参数体
sign string - 45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892 签名

# param 参数

参数名 必选 类型 长度限制 示例 说明
mchOrderId string 10-32 CCP20220428011068111 商户订单id, 格式:字母+数字,10-32位
channelCode string - BNI_VA 渠道编码
amount long 2000-100000000 50000 收款金额
customerName string 1-100 - 付款人姓名
email string - - 用户邮箱 格式:邮箱格式
mobile string - - 手机号码
idCardNumber string 16-18 - 付款人身份证号
notifyUrl string 商户交易通知 URL
timestamp long - 1678356680000 毫秒时间戳
expireTime long - 1678356680000 默认没有到期时间
remark string - - 收单备注

# channelCode参考此列表

# 请求体示例

{
  "appId": "abc6e413c37f14f9fabc36fcee8d97c5e",
  "sign": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "param": "{\"mchOrderId\":\"TestMchOrderIdP0002\",\"channelCode\":\"BRI_VA\",\"amount\":10000,\"email\":\"test@123.com\",\"mobile\":\"081234567\",\"customerName\":\"test\",\"remark\":\"test payment code\",\"notifyUrl\":\"http://test\",\"timestamp\":1678698098000}"
}

# 返回示例

参数名 必选 类型 长度限制 示例 说明
code integer 10000 参考此列表
message string Success 参考此列表
data object
-mchOrderId string 10-32 TestMchOrderIdP0002 商户订单号
-customerName string - test 付款人姓名
-expireTime string - 到期时间
-status string - ACTIVE 还款码状态
-paymentCodeList array -
--channelCode string - BNI_VA 渠道码
--referenceNumber string - 8558-1212-0247-4754 还款码

# code 参考此列表

# 成功响应示例

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "TestMchOrderIdP0002",
    "customerName": "test",
    "expireTime": null,
    "status": "ACTIVE",
    "paymentCode": {
      "channelCode": "BNI_VA",
      "referenceNumber": "8558121202474754"
    }
  }
}

# 失败响应示例

{
  "code": 21000,
  "message": "Service error, please contact administrator",
  "data": null
}