银联JS-获取用户标识

请求参数

Body 参数application/json

公共请求参数

orgId

string

机构号

必需

orgMercode

string

商户号

必需

orgTermno

string

终端号

必需

orgTrace

string

必需

交易流水，28位定长，规则：orgId 前四位+后四位+yyyyMMddhhmmss+6位自定义合计28位长度（唯一）

sign

string

签名

必需

signType

string

签名方式

必需

prodTrace

string

产品流水

可选

appendData

object (AppendReqData)

必需

aliGoodsDetail

array[object (AliGoodsDetail) {9}]

可选

ali:商品详情列表

aliExtendParams

object

可选

ali:业务拓展信息，支持功能：花呗分期、附加信息、扫码点单标识信息

aliBusinessParams

string

可选

ali:商户传入业务信息,用于安全/营销等参数直传场景, json

示例值:

{"data":"123"}

aliDisablePayChannels

string

可选

ali:禁用支付渠道,逗号分隔 https://docs.open.alipay.com/common/wifww7

aliDiscountableAmount

string

ali:可打折金额

可选

示例值:

aliEnablePayChannels

string

可选

ali:可用支付渠道,逗号分隔,与aliDisablePayChannels互斥,被扫无法支持此字段 https://docs.open.alipay.com/common/wifww7

aliOperatorId

string

ali:操作员编号

可选

aliSellerId

string

ali:卖家id

可选

aliStoreId

string

可选

ali:商户门店编号

aliTerminalParams

string

ali:终端参数

可选

示例值:

{"credential":"28763443825664394:20180207192030954:abcdefGHIJKLMN","signature":"xxxxxxx","terminalType":"IOT"}

aliUndiscountableAmount

string

可选

ali:不可打折金额

示例值:

alipayStoreId

string

可选

ali:支付宝门店编号

deviceInfo

string

微信设备号

可选

dgtlEnvlp

string

数字信封

可选

identity

object (付款人信息)

可选

实名支付；支付宝-支持上传所有字段：商户可直接使用；微信-仅支持W:开头的字段：并且需要像微信申请，仅支持商户为“保险”类目

invoiceSt

boolean

wx:是否支持发票

可选

示例值:

false

orgBasestation

string

基站信息

可选

orgDeviceIp

string

交易设备IP

可选

orgFrontFailUrl

string

必需

前台通知地址-云闪付-支付失败后的页面跳转地址

orgGpstype

string

GPS坐标系

可选

orgLatitude

string

维度

可选

orgLongitude

string

经度

可选

qrCode

string

二维码链接

必需

tradeCode=WUJS2时必填

payChannel

enum<string>

商户发起支付入口

可选

tradeCode=WUJS2时必填

枚举值:

0102

appUpIdentifier

string

银联支付标识

可选

tradeCode=WUJS2时必填

appid

string

商户微信APPID

可选

tradeCode=WUJS2时必填

userAuthCode

string

授权码

必需

qrPnrInsIdCd

string

可选

银联服务商机构标识码

qrSpecFeeInfo

string

可选

qr:特殊计费信息；固定长度3位。位置1~2：特殊计费类型；位置3：特殊计费档次

queryOptions

string

查询支付宝分期参数

可选

unQrAppCustomerInfo

string

可选

银行卡验证信息及身份信息在，整体加密后以字符串形式上送，具体结构参考:UnQrAppCustomerInfo

qrAcqAddnData

object (QrAcqAddnData)

可选

qr:收款方附加数据；https://doc.eycard.cn/web/#/42?page_id=3594

qrLimitAmt

object (QrLimitAmt)

银联二维码支付限额

可选

unQrAppInstalTransInfo

object (UnQrAppInstalTransInfo)

分期信息域

可选

unQrAppReserved

object (UnQrAppReserved)

保留域

可选

terminalinfo

object (TerminalInfo)

终端信息

可选

wxDetail

object (WxDetail)

wx:订单详情

可选

wxSceneInfo

object (WxSceneInfo)

wx:微信场景信息

可选

wxGoodsTag

string

可选

wx:订单优惠标记，代金券或立减优惠功能的参数

wxLimitPay

string

可选

wx:交易限制支付类型；取值-含义：{"no_credit":"禁用信用类型"}

示例值:

no_credit

data

object (银联二维码-JSAPI获取用户标识-请求)

必需

qrUserAuthCode

string

必需

授权码（付款方返回的临时授权码，一次有效）

qrAppUpIdentifier

string

银联支付标识

必需

qrAcqAddnData

object (QrAcqAddnData)

可选

orgInfo

string

请求方自定义信息

可选

示例

{
    "orgId": "string",
    "orgMercode": "string",
    "orgTermno": "string",
    "orgTrace": "string",
    "sign": "string",
    "signType": "string",
    "prodTrace": "string",
    "appendData": {
        "aliGoodsDetail": [
            {
                "alipay_goods_id": "string",
                "body": "string",
                "categories_tree": "string",
                "goods_category": "string",
                "goods_id": "string",
                "goods_name": "string",
                "price": "string",
                "quantity": 0,
                "show_url": "string"
            }
        ],
        "aliExtendParams": {
            "property1": {},
            "property2": {}
        },
        "aliBusinessParams": "{\"data\":\"123\"}",
        "aliDisablePayChannels": "string",
        "aliDiscountableAmount": "1",
        "aliEnablePayChannels": "string",
        "aliOperatorId": "string",
        "aliSellerId": "string",
        "aliStoreId": "string",
        "aliTerminalParams": "{\"credential\":\"28763443825664394:20180207192030954:abcdefGHIJKLMN\",\"signature\":\"xxxxxxx\",\"terminalType\":\"IOT\"}",
        "aliUndiscountableAmount": "1",
        "alipayStoreId": "string",
        "deviceInfo": "string",
        "dgtlEnvlp": "string",
        "identity": {
            "encryptInfo": "string",
            "fixBuyer": "string",
            "minage": "string",
            "needCheckInfo": "string",
            "type": "身份证：01；护照：02;军官证：03;士兵证：04;户口本：05 （微信只支持身份证）"
        },
        "invoiceSt": false,
        "orgBasestation": "string",
        "orgDeviceIp": "string",
        "orgFrontFailUrl": "string",
        "orgGpstype": "string",
        "orgLatitude": "string",
        "orgLongitude": "string",
        "qrCode": "string",
        "payChannel": "01",
        "appUpIdentifier": "string",
        "appid": "string",
        "userAuthCode": "string",
        "qrPnrInsIdCd": "string",
        "qrSpecFeeInfo": "string",
        "queryOptions": "string",
        "unQrAppCustomerInfo": "string",
        "qrAcqAddnData": {
            "customData": "string",
            "goodsInfos": [
                {
                    "addnInfo": "string",
                    "category": "string",
                    "id": "string",
                    "name": "string",
                    "price": "string",
                    "quantity": "string"
                }
            ],
            "orderInfo": {
                "addnInfo": "string",
                "dctAmount": "string",
                "description": "string",
                "title": "string"
            }
        },
        "qrLimitAmt": {
            "creditLimitAmt": "string",
            "debitLimitAmt": "string"
        },
        "unQrAppInstalTransInfo": {
            "instalRate": "string",
            "mchntFeeSubsidy": "string",
            "numberOfInstallments": "string"
        },
        "unQrAppReserved": {
            "cardNumberLock": "string",
            "customerId": "string",
            "discountCode": "string",
            "fundComCode": "string",
            "fundProCode": "string",
            "fundProType": "string"
        },
        "terminalinfo": {
            "appVersion": "string",
            "encryptRandNum": "string",
            "iccId": "string",
            "lbsNum1": "string",
            "lbsNum2": "string",
            "lbsNum3": "string",
            "lbsSignal1": "string",
            "lbsSignal2": "string",
            "lbsSignal3": "string",
            "location": "string",
            "locationCd1": "string",
            "locationCd2": "string",
            "locationCd3": "string",
            "mobileCountryCd": "string",
            "mobileNetNum": "string",
            "networkLicense": "string",
            "secretText": "string",
            "serialNum": "string",
            "telecomLbs": "string",
            "telecomLbsSignal": "string",
            "telecomNetId": "string",
            "telecomSysId": "string",
            "terminalId": "string",
            "terminalIp": "string",
            "terminalType": "string"
        },
        "wxDetail": {
            "costPrice": 0,
            "goodsDetail": [
                {
                    "goodsId": "string",
                    "goodsName": "string",
                    "price": 0,
                    "quantity": 0,
                    "wxpayGoodsId": "string"
                }
            ],
            "receiptId": "string"
        },
        "wxSceneInfo": {
            "address": "string",
            "areaCode": "string",
            "storeCode": "string",
            "storeName": "string"
        },
        "wxGoodsTag": "string",
        "wxLimitPay": "no_credit"
    },
    "data": {
        "qrUserAuthCode": "string",
        "qrAppUpIdentifier": "string",
        "qrAcqAddnData": {
            "customData": "string",
            "goodsInfos": [
                {
                    "addnInfo": "string",
                    "category": "string",
                    "id": "string",
                    "name": "string",
                    "price": "string",
                    "quantity": "string"
                }
            ],
            "orderInfo": {
                "addnInfo": "string",
                "dctAmount": "string",
                "description": "string",
                "title": "string"
            }
        }
    },
    "orgInfo": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://t-wapi.bhecard.com:8443/userId/qrGetUserId' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orgId": "string",
    "orgMercode": "string",
    "orgTermno": "string",
    "orgTrace": "string",
    "sign": "string",
    "signType": "string",
    "prodTrace": "string",
    "appendData": {
        "aliGoodsDetail": [
            {
                "alipay_goods_id": "string",
                "body": "string",
                "categories_tree": "string",
                "goods_category": "string",
                "goods_id": "string",
                "goods_name": "string",
                "price": "string",
                "quantity": 0,
                "show_url": "string"
            }
        ],
        "aliExtendParams": {
            "property1": {},
            "property2": {}
        },
        "aliBusinessParams": "{\"data\":\"123\"}",
        "aliDisablePayChannels": "string",
        "aliDiscountableAmount": "1",
        "aliEnablePayChannels": "string",
        "aliOperatorId": "string",
        "aliSellerId": "string",
        "aliStoreId": "string",
        "aliTerminalParams": "{\"credential\":\"28763443825664394:20180207192030954:abcdefGHIJKLMN\",\"signature\":\"xxxxxxx\",\"terminalType\":\"IOT\"}",
        "aliUndiscountableAmount": "1",
        "alipayStoreId": "string",
        "deviceInfo": "string",
        "dgtlEnvlp": "string",
        "identity": {
            "encryptInfo": "string",
            "fixBuyer": "string",
            "minage": "string",
            "needCheckInfo": "string",
            "type": "身份证：01；护照：02;军官证：03;士兵证：04;户口本：05 （微信只支持身份证）"
        },
        "invoiceSt": false,
        "orgBasestation": "string",
        "orgDeviceIp": "string",
        "orgFrontFailUrl": "string",
        "orgGpstype": "string",
        "orgLatitude": "string",
        "orgLongitude": "string",
        "qrCode": "string",
        "payChannel": "01",
        "appUpIdentifier": "string",
        "appid": "string",
        "userAuthCode": "string",
        "qrPnrInsIdCd": "string",
        "qrSpecFeeInfo": "string",
        "queryOptions": "string",
        "unQrAppCustomerInfo": "string",
        "qrAcqAddnData": {
            "customData": "string",
            "goodsInfos": [
                {
                    "addnInfo": "string",
                    "category": "string",
                    "id": "string",
                    "name": "string",
                    "price": "string",
                    "quantity": "string"
                }
            ],
            "orderInfo": {
                "addnInfo": "string",
                "dctAmount": "string",
                "description": "string",
                "title": "string"
            }
        },
        "qrLimitAmt": {
            "creditLimitAmt": "string",
            "debitLimitAmt": "string"
        },
        "unQrAppInstalTransInfo": {
            "instalRate": "string",
            "mchntFeeSubsidy": "string",
            "numberOfInstallments": "string"
        },
        "unQrAppReserved": {
            "cardNumberLock": "string",
            "customerId": "string",
            "discountCode": "string",
            "fundComCode": "string",
            "fundProCode": "string",
            "fundProType": "string"
        },
        "terminalinfo": {
            "appVersion": "string",
            "encryptRandNum": "string",
            "iccId": "string",
            "lbsNum1": "string",
            "lbsNum2": "string",
            "lbsNum3": "string",
            "lbsSignal1": "string",
            "lbsSignal2": "string",
            "lbsSignal3": "string",
            "location": "string",
            "locationCd1": "string",
            "locationCd2": "string",
            "locationCd3": "string",
            "mobileCountryCd": "string",
            "mobileNetNum": "string",
            "networkLicense": "string",
            "secretText": "string",
            "serialNum": "string",
            "telecomLbs": "string",
            "telecomLbsSignal": "string",
            "telecomNetId": "string",
            "telecomSysId": "string",
            "terminalId": "string",
            "terminalIp": "string",
            "terminalType": "string"
        },
        "wxDetail": {
            "costPrice": 0,
            "goodsDetail": [
                {
                    "goodsId": "string",
                    "goodsName": "string",
                    "price": 0,
                    "quantity": 0,
                    "wxpayGoodsId": "string"
                }
            ],
            "receiptId": "string"
        },
        "wxSceneInfo": {
            "address": "string",
            "areaCode": "string",
            "storeCode": "string",
            "storeName": "string"
        },
        "wxGoodsTag": "string",
        "wxLimitPay": "no_credit"
    },
    "data": {
        "qrUserAuthCode": "string",
        "qrAppUpIdentifier": "string",
        "qrAcqAddnData": {
            "customData": "string",
            "goodsInfos": [
                {
                    "addnInfo": "string",
                    "category": "string",
                    "id": "string",
                    "name": "string",
                    "price": "string",
                    "quantity": "string"
                }
            ],
            "orderInfo": {
                "addnInfo": "string",
                "dctAmount": "string",
                "description": "string",
                "title": "string"
            }
        }
    },
    "orgInfo": "string"
}'

返回响应

🟢200OK

application/json

Body

orgInfo

string

请求方自定义信息

可选

appendData

object (AppendRespData)

可选

disCount

object (DisCount)

可选

优惠详情；长度：6000

payDetail

object (PayDetail)

交易支付使用的资金

可选

riskInfo

object (RiskInfo)

风险控制信息

可选

data

object

可选

appendRetcode

string

可选

附加状态码，一般为支付渠道原文返回

appendRetmsg

string

可选

附加状态描述，一般为支付渠道原文返回

finRetcode

string

交易状态码

可选

payerId

string

可选

用户开放标识，用户ID

tradeCode

string

可选

交易码-->showDoc

issAddnData

object (QrIssAddnData)

可选

outCdnoType

string

转出卡类型

可选

riskInfo

string

风险控制信息

可选

userId

string

用户唯一编码

可选

sign

string

可选

sysRetcode

string

可选

sysRetmsg

string

可选

示例

{
    "sign": "XhNVzlsakExzKzwHBNUFmSErY0KOQ7GHh28DAq93ikAl/vSY0YUhq/AAac0VFiY3iSZITANTC8ZpobHJgxUFukFNqvQ2RccGLxWBE8oG3YIl7Z2oW9awnEpQnevYyeT+a1hni7U4GL3OBUrxj//F8fEQQG8FH3Y8bWDcGheQo6g=",
    "data": {
        "finRetcode": "00",
        "payerId": "2023041815450600018203"
    },
    "sysRetcode": "000000",
    "sysRetmsg": "success"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found