node tenpay
1.0.0
通知类中间件- notification du résultat du paiement, notification du résultat du remboursement前端支付支持- prend en charge JSAPI, WeixinJSBridge, les mini-programmes, APP, H5支付模式支持-code de paiement/compte officiel/mini programme/APP/H5/paiement par code scan支付工具支持- Enveloppe rouge WeChat, paiement d'entreprise (prend en charge le paiement en monnaie et par carte bancaire)营销功能支持- Bon WeChat对帐账单支持- prend en charge la déclaration WeChat et la facture de fonds WeChat服务商模式支持- toutes les API peuvent être transmises dans sub_appid, sub_mch_id微信支付仿真测试系统- prend en charge le mode sandbox, utilisé pour terminer le processus d'acceptation de paiement Groupe QQ : 157964097. Veuillez rejoindre le groupe pour les questions d'utilisation, le développement et les contributions au code.
noeudjs >= 8.3.0
En raison de problèmes sensibles tels que les montants impliqués, l'API et le middleware n'ont pas effectué de conversion de type sur les champs de données.
微信返回值XML做JSON转换之后的字段均为字符串类型, 请自行转换后再进行数据运算
'1' + 0 = '10'微信支付中传入的金额单位为分L'API et le middleware gèrent toutes les erreurs et les renvoient uniformément par erreur, notamment :
网络类错误- interruption du réseau, délai de connexion, etc.微信返回值检验错误- La valeur de retour WeChat est illégale (demandes falsifiées, etc., la possibilité est très faible)业务逻辑错误 : commandes en double, montant du remboursement supérieur au montant du paiement, etc.其它错误 : les paramètres à transmettre ne sont pas transmis, etc. Renvoie normalement les données au format JSON lorsqu'aucune erreur ne se produit
downloadBill et downloadFundflow est une chaîne littérale 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 – ID de compte officiel (obligatoire)mchid - Numéro de commerçant WeChat (obligatoire)partnerKey - Clé de sécurité des paiements WeChat (obligatoire, obtenue à partir de l'interface de gestion des commerçants WeChat)pfx - fichier de certificat (facultatif, obtenu à partir de l'interface de gestion des commerçants WeChat)notify_url - adresse de rappel de notification de résultat de paiement (facultatif)refund_url - adresse de rappel de la notification du résultat du remboursement (facultatif)spbill_create_ip - Adresse IP (facultatif)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 - La valeur par défaut est la valeur transmise lors de l'initialisation ou videspbill_create_ip - La valeur par défaut est la valeur transmise lors de l'initialisation ou 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 - par défaut le numéro du commerçant (ce champ apparaît dans le document de paiement du mini programme)notify_url - La valeur par défaut est l'url_remboursement transmis lors de l'initialisation. Sans ce paramètre, l'adresse de notification de remboursement configurée dans le backend du commerçant sera utilisée. 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 -TOUSformat -faux /**
* 新增一个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 -Basiqueformat -faux 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 - La valeur par défaut est la valeur transmise lors de l'initialisation ou 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 - Numéro de commande interne du commerçant (s'il est transmis, mch_autono ne sera pas valide)mch_autono - un numéro unique du jour à 10 chiffres, utilisé pour traiter automatiquement la logique interne du numéro de commande du commerçanttotal_num - 1client_ip - La valeur par défaut est la valeur du paramètre spbill_create_ip lors de l'initialisation ou 127.0.0.1scene_id - vide, doit être envoyé lorsque le montant de l'enveloppe rouge est supérieur à 2元(le document WeChat indique qu'il est de 200 yuans, la mesure réelle est de 2 yuans) 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 - Numéro de commande interne du commerçant (s'il est transmis, mch_autono ne sera pas valide)mch_autono - un numéro unique du jour à 10 chiffres, utilisé pour traiter automatiquement la logique interne du numéro de commande du commerçanttotal_num - 3, la valeur requise pour diviser l'enveloppe rouge est comprise entre 3 et 20amt_type -ALL_RANDscene_id - vide, doit être transmis lorsque le montant de l'enveloppe rouge est supérieur à 2元(non spécifié dans le document) api . redpackQuery ( {
mch_billno : '商户内部付款订单号'
} ) ; bill_type -MCHT
