node tenpay
1.0.0
通知类中间件– Benachrichtigung über Zahlungsergebnisse, Benachrichtigung über Rückerstattungsergebnisse前端支付支持– unterstützt JSAPI, WeixinJSBridge, Miniprogramme, APP, H5支付模式支持– Zahlungscode/offizielles Konto/Miniprogramm/APP/H5/Scan-Code-Zahlung支付工具支持– roter WeChat-Umschlag, Unternehmenszahlung (unterstützt die Zahlung von Wechselgeld und Bankkarte)营销功能支持– WeChat-Gutschein对帐账单支持– unterstützt den WeChat-Kontoauszug und den WeChat-Fondsgesetzentwurf服务商模式支持– alle APIs können in sub_appid, sub_mch_id übergeben werden微信支付仿真测试系统– unterstützt den Sandbox-Modus, der zum Abschließen des Zahlungsannahmeprozesses verwendet wird QQ-Gruppe: 157964097. Bitte treten Sie der Gruppe für Fragen zur Nutzung, zur Entwicklung und für Codebeiträge bei.
nodejs >= 8.3.0
Aufgrund sensibler Probleme wie etwa der beteiligten Beträge führten die API und die Middleware keine Typkonvertierung für die Datenfelder durch.
微信返回值XML做JSON转换之后的字段均为字符串类型, 请自行转换后再进行数据运算
'1' + 0 = '10'微信支付中传入的金额单位为分Sowohl die API als auch die Middleware verarbeiten alle Fehler und geben sie einheitlich durch Fehler zurück, einschließlich:
网络类错误– Netzwerkunterbrechung, Verbindungs-Timeout usw.微信返回值检验错误– Der WeChat-Rückgabewert ist illegal (gefälschte Anfragen usw., die Wahrscheinlichkeit ist sehr gering)业务逻辑错误– doppelte Bestellungen, Rückerstattungsbetrag ist höher als Zahlungsbetrag usw.其它错误– zu übergebende Parameter werden nicht übergeben usw. Normalerweise werden Daten im JSON-Format zurückgegeben, wenn kein Fehler auftritt
downloadBill und downloadFundflow heruntergeladenen Rechnung ist ein String-Literal npm i tenpay
# 如已安装旧版, 重新安装最新版
npm i tenpay@latest const tenpay = require ( 'tenpay' ) ;
const config = {
appid : '公众号ID' ,
mchid : '微信商户号' ,
partnerKey : '微信支付安全密钥' ,
pfx : require ( 'fs' ) . readFileSync ( '证书文件路径' ) ,
notify_url : '支付回调网址' ,
spbill_create_ip : 'IP地址'
} ;
// 方式一
const api = new tenpay ( config ) ;
// 方式二
const api = tenpay . init ( config ) ;
// 调试模式(传入第二个参数为true, 可在控制台输出数据)
const api = new tenpay ( config , true ) ;
// 沙盒模式(用于微信支付验收)
const sandboxAPI = await tenpay . sandbox ( config ) ; appid – Offizielle Konto-ID (erforderlich)mchid – WeChat-Händlernummer (erforderlich)partnerKey – WeChat-Zahlungssicherheitsschlüssel (erforderlich, erhalten Sie über die WeChat-Händlerverwaltungsschnittstelle)pfx – Zertifikatsdatei (optional, abgerufen über die WeChat-Händlerverwaltungsschnittstelle)notify_url – Rückrufadresse für die Benachrichtigung über das Zahlungsergebnis (optional)refund_url – Rückrufadresse für die Benachrichtigung über das Rückerstattungsergebnis (optional)spbill_create_ip – IP-Adresse (optional)127.0.0.1pay<支付结果通知, 默认> refund<退款结果通知> nativePay<扫码支付模式一回调> app . use ( bodyParser . text ( { type : '*/xml' } ) ) ;
// 支付结果通知/退款结果通知
router . post ( '/xxx' , api . middlewareForExpress ( 'pay' ) , ( req , res ) => {
let info = req . weixin ;
// 业务逻辑...
// 回复消息(参数为空回复成功, 传值则为错误消息)
res . reply ( '错误消息' || '' ) ;
} ) ;
// 扫码支付模式一回调
router . post ( '/xxx' , api . middlewareForExpress ( 'nativePay' ) , ( req , res ) => {
let info = req . weixin ;
// 业务逻辑和统一下单获取prepay_id...
// 响应成功或失败(第二个可选参数为输出错误信息)
res . replyNative ( prepay_id , err_msg ) ;
} ) ; app . use ( bodyParser ( {
enableTypes : [ 'json' , 'form' , 'text' ] ,
extendTypes : {
text : [ 'text/xml' , 'application/xml' ]
}
} ) ) ;
router . post ( '/xxx' , api . middleware ( 'refund' ) , async ctx => {
let info = ctx . request . weixin ;
// 业务逻辑...
// 回复消息(参数为空回复成功, 传值则为错误消息)
ctx . reply ( '错误消息' || '' ) ;
// 扫码支付模式一模式
ctx . replyNative ( prepay_id ) ;
} ) ; appid mchid let result = await api . getPayParams ( {
out_trade_no : '商户内部订单号' ,
body : '商品简单描述' ,
total_fee : '订单金额(分)' ,
openid : '付款用户的openid'
} ) ; trade_type – JSAPI // 该方法需先调用api.unifiedOrder统一下单, 获取prepay_id;
let result = await api . getPayParamsByPrepay ( {
prepay_id : '预支付会话标识'
} ) ; let result = await api . getAppParams ( {
out_trade_no : '商户内部订单号' ,
body : '商品简单描述' ,
total_fee : '订单金额(分)'
} ) ; trade_type -APP // 该方法需先调用api.unifiedOrder统一下单<注意传入trade_type: 'APP'>, 获取prepay_id;
let result = await api . getAppParamsByPrepay ( {
prepay_id : '预支付会话标识'
} ) ; let result = await api . getNativeUrl ( {
product_id : '商品ID'
} ) ; // 使用统一下单API可直接获取code_url, 需自行生成二维码图片
let { prepay_id , code_url } = await api . unifiedOrder ( {
out_trade_no : '商户内部订单号' ,
body : '商品简单描述' ,
total_fee : '订单金额(分)' ,
openid : '用户openid' ,
trade_type : 'NATIVE' ,
product_id : '商品id'
} ) ; let result = await api . micropay ( {
out_trade_no : '商户内部订单号' ,
body : '商品简单描述' ,
total_fee : '订单金额(分)' ,
auth_code : '授权码'
} ) ; let result = await api . unifiedOrder ( {
out_trade_no : '商户内部订单号' ,
body : '商品简单描述' ,
total_fee : '订单金额(分)' ,
openid : '用户openid'
} ) ; trade_type – JSAPInotify_url – Standardmäßig der während der Initialisierung übergebene Wert oder leerspbill_create_ip – Standardmäßig der während der Initialisierung übergebene Wert oder 127.0.0.1 let result = await api . orderQuery ( {
// transaction_id, out_trade_no 二选一
// transaction_id: '微信的订单号',
out_trade_no : '商户内部订单号'
} ) ; let result = await api . reverse ( {
// transaction_id, out_trade_no 二选一
// transaction_id: '微信的订单号',
out_trade_no : '商户内部订单号'
} ) ; let result = await api . closeOrder ( {
out_trade_no : '商户内部订单号'
} ) ; let result = await api . refund ( {
// transaction_id, out_trade_no 二选一
// transaction_id: '微信的订单号',
out_trade_no : '商户内部订单号' ,
out_refund_no : '商户内部退款单号' ,
total_fee : '订单金额(分)' ,
refund_fee : '退款金额(分)'
} ) ; op_user_id – standardmäßig die Händlernummer (dieses Feld erscheint im Miniprogramm-Zahlungsdokument)notify_url – Der Standardwert ist die bei der Initialisierung übergebene „refund_url“. Ohne diesen Parameter wird die im Backend des Händlers konfigurierte Adresse für die Rückerstattungsbenachrichtigung verwendet. let result = await api . refundQuery ( {
// 以下参数 四选一
// transaction_id: '微信的订单号',
// out_trade_no: '商户内部订单号',
// out_refund_no: '商户内部退款单号',
refund_id : '微信退款单号'
} ) ; /**
* 新增一个format参数(默认: false), 用于自动转化帐单为json格式
* json.total_title: 统计数据的标题数组 - ["总交易单数","总交易额","总退款金额", ...],
* json.total_data: 统计数据的数组 - ["3", "88.00", "0.00", ...],
* json.list_title: 详细数据的标题数组 - ["交易时间","公众账号ID","商户号", ...],
* json.list_data: 详细数据的二维数据 - [["2017-12-26 19:20:39","wx12345", "12345", ...], ...]
*/
let result = await api . downloadBill ( {
bill_date : '账单日期'
} , true ) ; bill_type -ALLformat -false /**
* 新增一个format参数(默认: false), 用于自动转化帐单为json格式
* json.total_title: 统计数据的标题数组 - ["资金流水总笔数","收入笔数","收入金额", ...],
* json.total_data: 统计数据的数组 - ["20.0", "17.0", "0.35", ...],
* json.list_title: 详细数据的标题数组 - ["记账时间","微信支付业务单号","资金流水单号", ...],
* json.list_data: 详细数据的二维数据 - [["2018-02-01 04:21:23","12345", "12345", ...], ...]
*/
let result = await api . downloadFundflow ( {
bill_date : '账单日期'
} , true ) ; account_type -Basicformat -false let result = await api . sendCoupon ( {
coupon_stock_id : '代金券批次id' ,
partner_trade_no : '商户单据号' ,
openid : '用户openid'
} ) ; let result = await api . queryCouponStock ( {
coupon_stock_id : '代金券批次id'
} ) ; let result = await api . queryCouponInfo ( {
coupon_id : '代金券id' ,
openid : '用户openid' ,
stock_id : '批次号'
} ) ; let result = await api . transfers ( {
partner_trade_no : '商户内部付款订单号' ,
openid : '用户openid' ,
re_user_name : '用户真实姓名' ,
amount : '付款金额(分)' ,
desc : '企业付款描述信息'
} ) ; check_name – FORCE_CHECKspbill_create_ip – Standardmäßig der während der Initialisierung übergebene Wert oder 127.0.0.1 let result = await api . transfersQuery ( {
partner_trade_no : '商户内部付款订单号'
} ) ; let result = await api . payBank ( {
partner_trade_no : '商户内部付款订单号' ,
bank_code : '收款方开户行' ,
enc_bank_no : '收款方银行卡号' ,
enc_true_name : '收款方用户名' ,
amount : '付款金额(分)' ,
desc : '企业付款到银行卡描述信息'
} ) ; let result = await api . queryBank ( {
partner_trade_no : '商户内部付款订单号'
} ) ; let result = await api . sendRedpack ( {
// mch_billno, mch_autono 二选一
// mch_billno: '商户内部付款订单号',
mch_autono : '10位当日唯一数字, 用于自动生成mch_billno' ,
send_name : '商户名称' ,
re_openid : '用户openid' ,
total_amount : '红包金额(分)' ,
wishing : '红包祝福语' ,
act_name : '活动名称' ,
remark : '备注信息'
} ) ; mch_billno – Interne Bestellnummer des Händlers (bei Übergabe ist mch_autono ungültig)mch_autono – eine 10-stellige eindeutige Nummer des Tages, die zur automatischen Verarbeitung der internen Bestellnummernlogik des Händlers verwendet wirdtotal_num - 1client_ip – Standardmäßig der Wert des Parameters spbill_create_ip während der Initialisierung oder 127.0.0.1scene_id – leer, muss gesendet werden, wenn der Betrag des roten Umschlags mehr als 2元beträgt (das WeChat-Dokument gibt an, dass es sich um 200 Yuan handelt, der tatsächliche Wert beträgt 2 Yuan). let result = await api . sendGroupRedpack ( {
// mch_billno, mch_autono 二选一
// mch_billno: '商户内部付款订单号',
mch_autono : '10位当日唯一数字, 用于自动生成mch_billno' ,
send_name : '商户名称' ,
re_openid : '种子用户openid' ,
total_amount : '红包金额(分)' ,
wishing : '红包祝福语' ,
act_name : '活动名称' ,
remark : '备注信息'
} ) ; mch_billno – Interne Bestellnummer des Händlers (bei Übergabe ist mch_autono ungültig)mch_autono – eine 10-stellige eindeutige Nummer des Tages, die zur automatischen Verarbeitung der internen Bestellnummernlogik des Händlers verwendet wirdtotal_num - 3, der erforderliche Wert zum Aufteilen des roten Umschlags liegt zwischen 3 und 20amt_type -ALL_RANDscene_id – leer, muss übergeben werden, wenn der Betrag des roten Umschlags mehr als 2元beträgt (nicht im Dokument angegeben) api . redpackQuery ( {
mch_billno : '商户内部付款订单号'
} ) ; bill_type -MCHT
