云闪付 APP 支付

请求参数

Body 参数application/json

version

string

版本号

必需

outTradeNo

string

商户订单号

必需

customerCode

string

商户编号

必需

terminalCode

string

终端代码

必需

clientIp

string

用户的出口 IP

必需

orderInfo

object (OrderInfo)

必需

string

商品订单编号

必需

businessType

string

业务种类

必需

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

goodsList

array[object (OrderGoods) {3}]

订单商品列表

可选

payAmount

integer <int64>

支付金额

必需

payCurrency

string

支付币种

必需

notifyUrl

string

支付结果通知地址

必需

redirectUrl

string

可选

商户支付结果展示地址

attachData

string

商户备注

可选

transactionStartTime

string

必需

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

transactionEndTime

string

可选

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

nonceStr

string

随机字符串

必需

needSplit

boolean

是否分账

可选

splitInfoList

array[object (SplitInfo) {3}]

分账信息列表

可选

customerCode

string

可选

amount

integer <int64>

可选

isProcedureCustomer

integer <int32>

可选

splitNotifyUrl

string

可选

分账结果异步通知 URL

splitAttachData

string

分账备注

可选

splitModel

string

分账模式

可选

splitMain

string

分账主体商户

可选

terminalInfo

object (TerminalInfo)

可选

location

string

可选

network_license

string

可选

terminal_type

string

可选

serial_num

string

可选

terminal_id

string

可选

encrypt_rand_num

string

可选

secret_text

string

可选

app_version

string

可选

terminal_ip

string

可选

mobile_country_cd

string

可选

mobile_net_num

string

可选

icc_id

string

可选

location_cd1

string

可选

lbs_num1

string

可选

lbs_signal1

string

可选

location_cd2

string

可选

lbs_num2

string

可选

lbs_signal2

string

可选

location_cd3

string

可选

lbs_num3

string

可选

lbs_signal3

string

可选

telecom_sys_id

string

可选

telecom_net_id

string

可选

telecom_lbs

string

可选

telecom_lbs_signal

string

可选

areaInfo

string

可选

商户所在地区信息，6 位定长，精确到区县编码维度

noCreditCards

boolean

可选

subAppId

string

可选

payMethod

string

可选

subCustomerCode

string

可选

splitRelationId

string

分账关系序列号

可选

示例

{
  "version": "string",
  "outTradeNo": "string",
  "customerCode": "string",
  "terminalCode": "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",
  "nonceStr": "string",
  "needSplit": true,
  "splitInfoList": [
    {
      "customerCode": "string",
      "amount": 0,
      "isProcedureCustomer": 0
    }
  ],
  "splitNotifyUrl": "string",
  "splitAttachData": "string",
  "splitModel": "string",
  "splitMain": "string",
  "terminalInfo": {
    "location": "string",
    "network_license": "string",
    "terminal_type": "string",
    "serial_num": "string",
    "terminal_id": "string",
    "encrypt_rand_num": "string",
    "secret_text": "string",
    "app_version": "string",
    "terminal_ip": "string",
    "mobile_country_cd": "string",
    "mobile_net_num": "string",
    "icc_id": "string",
    "location_cd1": "string",
    "lbs_num1": "string",
    "lbs_signal1": "string",
    "location_cd2": "string",
    "lbs_num2": "string",
    "lbs_signal2": "string",
    "location_cd3": "string",
    "lbs_num3": "string",
    "lbs_signal3": "string",
    "telecom_sys_id": "string",
    "telecom_net_id": "string",
    "telecom_lbs": "string",
    "telecom_lbs_signal": "string"
  },
  "areaInfo": "string",
  "noCreditCards": true,
  "subAppId": "string",
  "payMethod": "string",
  "subCustomerCode": "string",
  "splitRelationId": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/pay/unionAppPay' \
--header 'Content-Type: application/json' \
--data-raw '{
    "version": "string",
    "outTradeNo": "string",
    "customerCode": "string",
    "terminalCode": "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",
    "nonceStr": "string",
    "needSplit": true,
    "splitInfoList": [
        {
            "customerCode": "string",
            "amount": 0,
            "isProcedureCustomer": 0
        }
    ],
    "splitNotifyUrl": "string",
    "splitAttachData": "string",
    "splitModel": "string",
    "splitMain": "string",
    "terminalInfo": {
        "location": "string",
        "network_license": "string",
        "terminal_type": "string",
        "serial_num": "string",
        "terminal_id": "string",
        "encrypt_rand_num": "string",
        "secret_text": "string",
        "app_version": "string",
        "terminal_ip": "string",
        "mobile_country_cd": "string",
        "mobile_net_num": "string",
        "icc_id": "string",
        "location_cd1": "string",
        "lbs_num1": "string",
        "lbs_signal1": "string",
        "location_cd2": "string",
        "lbs_num2": "string",
        "lbs_signal2": "string",
        "location_cd3": "string",
        "lbs_num3": "string",
        "lbs_signal3": "string",
        "telecom_sys_id": "string",
        "telecom_net_id": "string",
        "telecom_lbs": "string",
        "telecom_lbs_signal": "string"
    },
    "areaInfo": "string",
    "noCreditCards": true,
    "subAppId": "string",
    "payMethod": "string",
    "subCustomerCode": "string",
    "splitRelationId": "string"
}'

返回响应

🟢200成功

*/*

Body

响应信息主体

code

integer <int32>

可选

msg

string

可选

data

object (UnionPayAppResponse)

可选

returnCode

string

必需

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

returnMsg

string

信息

可选

consoleMsg

string

可选

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

outputJSON

string

可选

outTradeNo

string

必需

amount

integer <int64>

必需

string

可选

成功时必须，App 端 SDK 根据此订单号
完成交易

couponDetails

array[object (CouponDetail) {7}]

可选

nonceStr

string

必需

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

示例

{
  "code": 0,
  "msg": "string",
  "data": {
    "returnCode": "string",
    "returnMsg": "string",
    "consoleMsg": "string",
    "outputJSON": "string",
    "outTradeNo": "string",
    "amount": 0,
    "tn": "string",
    "couponDetails": [
      {
        "couponCode": "string",
        "amount": 0,
        "type": "string",
        "contributor": "string",
        "createTime": "string",
        "state": "string",
        "remarks": "string"
      }
    ],
    "nonceStr": "string"
  }
}