主扫支付(云闪付)

请求参数

Body 参数application/json

outTradeNo

string

商户订单号

必需

最长 32 个字符，商户需保证在该商户
范围内唯一

customerCode

string | null

商户编号

可选

clientIp

string

clientIp

可选

用户访问商户系统服务端时的出口 IP

orderInfo

object (OrderInfo)

商品订单信息

必需

id

string

商品订单编号

必需

businessType

string

业务种类

必需

商品订单业务种类编码见附录

goodsList

array[object (OrderGoods) {3}]

订单商品列表

可选

payAmount

integer <int64>

支付金额

必需

单位为分

payCurrency

string

支付币种

必需

默认 CNY:人民币

notifyUrl

string

支付结果通知地址

必需

异步通知地址，建议使用 https 协议

redirectUrl

string

商户支付结果展示地址

可选

支付系统完成支付后，将用户重
定向至该地址，携带支付结果，定义见
“支付结果同步跳转（IF-Cashier-
02）”，地址最后不允许携带参数

attachData

string

商户备注

可选

通知和查询接口中原样返回

transactionStartTime

string

交易开始时间

必需

商户系统发起交易的时间，格式：
YYYYMMDDHHMMSS，北京时间

transactionEndTime

string

交易超时时间

可选

该笔交易允许的最晚付款时间，逾期将
关闭交易。格式：
YYYYMMDDHHMMSS；默认：
transactionStartTime+30 分钟，最
大：transactionStartTime+24 小时

payMethod

string

支付方式

必需

24 云闪付扫码

nonceStr

string

随机字符串

必需

随机字符串，推荐随机数生成算法产生

areaInfo

string

地区信息

必需

商户所在地区信息，6 位定长，精确到
区县编码维度，取值参考附录地区编码

needSplit

boolean

可选

noCreditCards

boolean

是否禁止信用卡支付

必需

true:禁止信用卡支付
false:允许信用卡支付
默认 false

version

string

版本号

必需

3.0
请填最新版本 3.0，会兼容小于 3.0 或
为空的版本

示例

{
  "outTradeNo": "string",
  "customerCode": "string",
  "clientIp": "string",
  "orderInfo": {
    "id": "string",
    "businessType": "string",
    "goodsList": [
      {
        "name": "string",
        "number": "string",
        "amount": 0
      }
    ]
  },
  "payAmount": 0,
  "payCurrency": "string",
  "notifyUrl": "string",
  "redirectUrl": "string",
  "attachData": "string",
  "transactionStartTime": "string",
  "transactionEndTime": "string",
  "payMethod": "string",
  "nonceStr": "string",
  "areaInfo": "string",
  "needSplit": true,
  "noCreditCards": true,
  "version": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/pay/nativePay' \
--header 'Content-Type: application/json' \
--data-raw '{
    "outTradeNo": "string",
    "customerCode": "string",
    "clientIp": "string",
    "orderInfo": {
        "id": "string",
        "businessType": "string",
        "goodsList": [
            {
                "name": "string",
                "number": "string",
                "amount": 0
            }
        ]
    },
    "payAmount": 0,
    "payCurrency": "string",
    "notifyUrl": "string",
    "redirectUrl": "string",
    "attachData": "string",
    "transactionStartTime": "string",
    "transactionEndTime": "string",
    "payMethod": "string",
    "nonceStr": "string",
    "areaInfo": "string",
    "needSplit": true,
    "noCreditCards": true,
    "version": "string"
}'

返回响应

🟢200成功

*/*

OK

Body

code

integer <int32>

可选

msg

string

可选

data

object (NativePayResponse)

可选

returnCode

string

可选

返回状态码; 0000：处理成功;0000：处理成功

returnMsg

string

信息

可选

consoleMsg

string

可选

打印控制台信息。注意：此属性仅用于页面显示调试信息，实际交易中并不存在

outputJSON

string

可选

codeUrl

string

扫码URL

可选

outTradeNo

string

商户单号

可选

amount

integer <int64>

支付金额

可选

nonceStr

string

可选

示例

{
  "code": 0,
  "msg": "string",
  "data": {
    "returnCode": "string",
    "returnMsg": "string",
    "consoleMsg": "string",
    "outputJSON": "string",
    "codeUrl": "string",
    "outTradeNo": "string",
    "amount": 0,
    "nonceStr": "string"
  }
}