n-pay

v2.0.3

Published

2 years ago

n-pay支付模块

Downloads

0High
0Medium
0Low

navyxie

支付连连易宝 pp钱包 yeepay lianlian paypalm

支付服务

目前支持连连支付、易宝支付、pp钱支付、闪豆支付、宝付支付、汇付托管支付。类似ping++

注意发布logs,新增汇付支付,函数传参有所不同

安装

npm install n-pay

初始化

var nPay = require('n-pay');
var PAY = nPay({
	appid:'your appid',
	appkey:'your appkey',
	serverDomain:'http://pay.kaolalicai.cn',
	npay_version:'1.0',
	npay_sign_type:'RSA',
	cryptoConfig:{
		'md5_key':'',//md5 key
		'des_key':'',//des key,24个字符长度
		'aes_key':'',//aes key,16个字符长度
		'merchant_pri_key':'',
		'npay_pub_key':''
	}
})
//appid,appkey请向广州财略金融信息科技有限公司申请

API

##获取支付内容（html或者url）

pay(paymentConfig,orderInfo,cb)

paymentConfig(object):支付渠道配置，配置channel和merchant_account，
orderInfo(object)：订单信息，必须包含字段:'order_id','user_id','amount','trans_time','reg_time','return_url','notify_url','order_desc';idcard,card_no,acct_name为可选
cb(function):回调函数：err,data;data为objec,code为0时表示成功获取支付内容，data:支付内容，notify_url：服务异步回调地址(native app需要用到)

PAY.pay(
    {
		channel:'pay channel ,such as yeepay',
		merchant_account:'your pay channel account'
    },
    {
		'order_id':"abc_test",//订单id,长度必须小于等于32位
		'user_id':"abc_user",//用户在商户系统中的id
		'amount':0.01,//支付金额，元为单位
		'trans_time':Date.now(),//交易时间（时间戳）
		'reg_time':Date.now(),//用户在商户系统中的注册时间（时间戳）
		'return_url':"http://www.kaolalicai.cn",//支付结果跳转页（同步）
		'notify_url':"http://www.kaolalicai.cn",//支付结果通知地址（异步），只有支付成功才会像这个地址post数据
		'order_desc':"test pay",//订单描述
		'idcard':'',
		'card_no':'',
		'acct_name':'',
		'reg_phone':'user register phone'//用户在商户系统中注册的手机号（channel为ppwallet时必传）
    },
    function(err,data){
        if(!err && data.code === 0){
			//todo,这里为支付的内容(url或一段html的form表单)
			//web段使用例子：
			//var data = data.data;
			// if(/^http/.test(data)){
			// 	window.location.href = data;
			// }else{
			// 	document.getElementsByTagName('body')[0].innerHTML = data;
			// 	document.forms[0].submit();
			// }
        }else{
			//todo,请求失败
        }
    }
)

查询订单是否支付成功

query(paymentConfig,queryInfo,cb)

paymentConfig(object):支付渠道配置，配置channel和merchant_account，
queryInfo(object)：订单信息，必须包含字段:'order_id',
cb(function):回调函数：err,data;data为objec,code为0时表示订单支付成功。

需要注意的是，pp钱包目前没有查询订单的接口，当code为-2时，需要去pp钱包后台确认订单最终支付情况。

PAY.query(
    {
		channel:'pay channel ,such as yeepay',
		merchant_account:'your pay channel account'
    },
    {
		'order_id':"abc_test"
    },
    function(err,data){
        if(!err){
			if(data.code === 0){
				//todo,支付成功，商户可以进行订单更新或者发货了。
			}else if(data.code === -2){
				//todo,支付成功，但是需要去第三方支付平台确认最终支付情况。
			}else{
				//todo.支付不成功。
			}
        }else{
			//todo,请求失败
        }
    }
)

获取系统中支持的支付渠道

getPayment(cb)

返回结果为json格式数据
返回json包含字段code,data，code 为0表示获取成功，其他则为失败。data为string

PAY.getPayment(
	function(err,data){
		if(!err){
			if(data.code){
				console.log(data.data);//string ,'yeepay,llpay,ppwallet'
			}
		}
	}
)

回调处理（格式为json,包涵sign和ciphertext字段）

异步回调(post请求,带有参数sign,ciphertext)

同步回调(get请求,带有参数sign,ciphertext)

解密后的数据plaintext:plaintext.pay_result为字符串0表示支付成功

var parseData = PAY.paySuccess(sign,ciphertext,npay_sign_type);
if(parseData.success){
	//todo,可以发货了
	//订单详细信息,parseData.plaintext
	//res.send(PAY.getStopNotifyData())
}

终止回调

res.send(PAY.getStopNotifyData())

当商户接收回调后，返回一段非空字符串，比如success将会终止回调

npay_version:2.0
2.0以上版本支持汇付支付,npay_version传值2.0
新增字段pageType(页面类型,pc或者移动),merPriv商户私有域
获取终止异步回调的字符串需传入第三方返回的原始数据,即接口:getStopNotifyData
汇付支付的时候需要传用户在汇付开户的用户客户号,即third_user_id字段,对应汇付原始字段UsrCustId
为适配汇付订单查询,查询接口新增字段queryTransType,充值订单为SAVE,提现订单为CASH
购买接口原路返回第三方支付的回调结果,字段名:origin,数据格式为json字符串(商户需自己调用JSON.parse进行解析).