node-unionpay-sdk

银联支付/云闪付 NodeJS SDK, 目前支持如下:

• 在线网关支付 createWebOrder
• 银联响应数据及回调通知验证(证书链验证) getResponseVerify
• 云闪付APP支付 createAppOrder
• 统一支付接口 trans
• 当日消费撤销 cancelOrder
• 退款 refundOrder
• 交易状态查询 queryOrder

环境依赖

1. 目前测试 Node 14.15.1 及以上版本正常运行
2. Windows 需要安装 openssl 并添加到运行环境, 点击下载OpenSSL_1_1_1.msi

安装

npm

npm install @lipingruan/node-unionpay-sdk

yarn

yarn add @lipingruan/node-unionpay-sdk

初始化

const Unionpay = require ( '@lipingruan/node-unionpay-sdk' )

const unionpay = new Unionpay ( {
    sandbox: true,
    merId: '商户号',
    consumeCallbackUrl: '付款成功后台回调地址',
    cancelOrderCallbackUrl: '订单撤销后台回调地址',
    refundOrderCallbackUrl: '退款订单后台回调地址',
    certification: 'pfx证书',
    certificationPassword: 'pfx证书密码',
    unionpayRootCA: '银联根证书',
    unionpayMiddleCA: '银联中级证书',
    // 更多参数见<初始化参数列表>
} )

初始化参数列表

特别说明: 证书可传绝对地址或文件内容(fs.readFileSync)

参数	类型	默认值	说明
sandbox	boolean	true	是否沙箱环境
version	string	5.1.0	接口版本
encoding	string	UTF-8	报文编码
merId	string	null	商户号
certification	string/buffer	null	商户pfx证书
certificationPassword	string	null	商户证书密码
unionpayRootCA	string/buffer	null	银联根证书
unionpayMiddleCA	string/buffer	null	银联中级证书
consumeCallbackUrl	string	null	付款成功回调地址
cancelOrderCallbackUrl	string	null	撤销订单回调
refundOrderCallbackUrl	string	null	退款订单回调
accessType	string	0	接入类型
channelType	string	07	渠道类型
currencyCode	string	156	交易货币代码

在线Web网关支付

try {
    
    // 下单时间是非常重要的参数，请保存至数据库，不然隔天查不到订单信息
    const txnTime = new Date ( )

    const { redirect } = await unionpay.createWebOrder ( {
        // required:string 商户订单号
        orderId: '20220307968496436', 
        // required:Date 下单时间
        txnTime, 
        // required:number 交易金额, 单位:分
        txnAmt: 100, 
        // optional:string 交易描述
        orderDesc: '这是交易描述', 
        // optional:string 附加数据, 回调原样返回
        reqReserved: 'a=1&b=2', 
        // optional:string 渠道类型, 07:PC/平板,09:手机
        channelType: '07', 
        // required:string 前端付款完成后跳转页面
        frontUrl: 'https://xxx.com/order?id=20220307968496436',
        // optional:string 付款完成后台回调地址，不传则使用初始化配置的 consumeCallbackUrl
        backUrl: 'https://xxx.com/payment/callback',
        // ...以及其它任何官方字段
    } )
    // redirect 为银联付款网页链接
} catch ( error ) {
    
    console.error ( '银联下单失败:', error.message )
}

云闪付APP支付

try {

    // 下单时间是非常重要的参数，请保存至数据库，不然隔天查不到订单信息
    const txnTime = new Date ( )

    const { tn } = await unionpay.createAppOrder ( {
        // required:string 商户订单号
        orderId: '20220307968496436', 
        // required:Date 下单时间
        txnTime, 
        // required:number 交易金额, 单位:分
        txnAmt: 100, 
        // required:string 交易描述
        orderDesc: '这是交易描述', 
        // optional:string 附加数据, 回调原样返回
        reqReserved: 'a=1&b=2', 
        // required:string 前端付款完成后跳转页面
        frontUrl: 'https://xxx.com/order?id=20220307968496436',
        // optional:string 付款完成后台回调地址，不传则使用初始化配置的 consumeCallbackUrl
        backUrl: 'https://xxx.com/payment/callback',
        // ...以及其它任何官方字段
    } )
    // tn 为银联受理订单号, 调起云闪付支付使用
} catch ( error ) {
    
    console.error ( '银联下单失败:', error.message )
}

订单查询

const { status, queryId, body } = await unionpay.queryOrder ( {
    orderId: '付款单号/撤单单号/退款单号',
    // required:Date 下单时间
    txnTime: 1648609466613, 
    // ...以及其它任何官方字段
} )
// status SUCCESS: 成功, PENDING: 处理中, FAIL: 失败
// queryId 为银联流水号，存到数据库
// body 为响应原始数据

当日消费撤销

// 撤销订单的下单时间，非原支付订单下单时间，同样保存至数据库
const txnTime = new Date ( )

const body = await unionpay.cancelOrder ( {
    orderId: '撤单单号，不是付款单号',
    // required:Date 撤销时间
    txnTime,
    // required:string 原支付订单银联流水号
    origQryId: '原订单的银联流水号，查已付款订单或者付款回调里的queryId',
    // required:number 订单金额（分），必须与原订单一致
    txnAmt: 100,
    // optional:string 撤销完成后台回调地址，不传则使用初始化配置的 cancelOrderCallbackUrl
    backUrl: 'https://xxx.com/payment/cancel/callback',
    // ...以及其它任何官方字段
} )
// body 为撤单接口响应原始数据，需要保存至数据库
// 没报错表示发送成功，后续接收cancelOrderCallbackUrl回调或主动调用queryOrder接口查询

退款

// 退款订单的下单时间，非原支付订单下单时间，同样保存至数据库
const txnTime = new Date ( )

const body = await unionpay.cancelOrder ( {
    orderId: '退款单号，不是付款单号',
    // required:Date 退款时间
    txnTime,
    // required:string 原支付订单银联流水号
    origQryId: '原订单的银联流水号，查已付款订单或者付款回调里的queryId',
    // required:number 退款金额（分）
    txnAmt: 100,
    // optional:string 撤销完成后台回调地址，不传则使用初始化配置的 refundOrderCallbackUrl
    backUrl: 'https://xxx.com/payment/refund/callback',
    // ...以及其它任何官方字段
} )
// body 为撤单接口响应原始数据，需要保存至数据库
// 没报错表示发送成功，后续接收cancelOrderCallbackUrl回调或主动调用queryOrder接口查询

银联数据验证

const body = { } // 银联回调数据

const verified = unionpay.getResponseVerify ( body )

console.log ( `回调验证${verified?'通过':'失败'}` )