Descarga de node tenpay - Descarga del código fuente node tenpay

Pago WeChat para nodejs

Resumen de funciones

通知类中间件: notificación de resultado de pago, notificación de resultado de reembolso
前端支付支持: admite JSAPI, WeixinJSBridge, miniprogramas, APP, H5
支付模式支持: código de pago/cuenta oficial/mini programa/APP/H5/pago con código de escaneo
支付工具支持: sobre rojo de WeChat, pago corporativo (admite pago con cambio y tarjeta bancaria)
营销功能支持vale WeChat
对帐账单支持: respalda la declaración de WeChat y el proyecto de ley de fondos de WeChat
服务商模式支持: todas las API se pueden pasar en sub_appid, sub_mch_id
微信支付仿真测试系统: admite el modo sandbox y se utiliza para completar el proceso de aceptación de pagos.

grupo de comunicacion

Grupo QQ: 157964097. Únase al grupo para preguntas sobre uso, desarrollo y contribuciones de código.

Debe leer antes de usar

Requisitos de versión

nodejs >= 8.3.0

Acerca de los tipos de datos de los valores entrantes y los valores de retorno de WeChat

Debido a cuestiones delicadas, como las cantidades involucradas, la API y el middleware no realizaron la conversión de tipos en los campos de datos.
微信返回值XML做JSON转换之后的字段均为字符串类型, 请自行转换后再进行数据运算

centrarse en los problemas

Problema de resultado de operación de cadena y número '1' + 0 = '10'
Emisión de unidad de cantidad:微信支付中传入的金额单位为分

Sobre el error

Tanto la API como el middleware manejan todos los errores y los devuelven de manera uniforme mediante errores, incluidos:

网络类错误: interrupción de la red, tiempo de espera de conexión, etc.
微信返回值检验错误: el valor de retorno de WeChat es ilegal (solicitudes falsificadas, etc., la posibilidad es muy baja)
业务逻辑错误: pedidos duplicados, el monto del reembolso es mayor que el monto del pago, etc.
其它错误: los parámetros a pasar no se pasan, etc.

Acerca del valor de retorno

Normalmente devuelve datos en formato JSON cuando no se produce ningún error.

Caso especial: el valor de retorno de la factura descargada por downloadBill y downloadFundflow es una cadena literal

Instalar

npm i tenpay

# 如已安装旧版, 重新安装最新版
npm i tenpay@latest

Crear una instancia

 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 ) ;

descripción de configuración:

appid - ID de cuenta oficial (obligatorio)
mchid : número de comerciante de WeChat (obligatorio)
partnerKey : clave de seguridad de pago de WeChat (obligatoria, obtenida de la interfaz de administración de comerciantes de WeChat)
pfx : archivo de certificado (opcional, obtenido de la interfaz de administración de comerciantes de WeChat)
- No es necesario completar este parámetro cuando no es necesario llamar a API que dependen de certificados.
- Si se utiliza una API dependiente de certificado en el proceso empresarial, este parámetro debe pasarse durante la inicialización.
notify_url : dirección de devolución de llamada de notificación del resultado del pago (opcional)
- Puede pasarlo durante la inicialización y establecerlo como valor predeterminado. De lo contrario, debe pasarlo al llamar a la API correspondiente.
- Si se pasa un nuevo valor al llamar a la API correspondiente, se utilizará el nuevo valor.
refund_url : dirección de devolución de llamada de notificación del resultado del reembolso (opcional)
- Puede pasarlo durante la inicialización y establecerlo como valor predeterminado. De lo contrario, utilice la configuración en segundo plano del comerciante de WeChat.
- Si se pasa un nuevo valor al llamar a la API correspondiente, se utilizará el nuevo valor.
spbill_create_ip - dirección IP (opcional)
- Puede pasarlo durante la inicialización y establecerlo como valor predeterminado. Si no lo pasa, el valor predeterminado es 127.0.0.1
- Si se pasa un nuevo valor al llamar a la API correspondiente, se utilizará el nuevo valor.

Mejores prácticas para parámetros opcionales:

Si se utiliza una API que contiene una solicitud de certificado en el proceso de negocio, el parámetro pfx se debe pasar inicialmente
Si no es necesario cambiar la dirección de devolución de llamada según el negocio, se recomienda pasar una dirección de devolución de llamada unificada durante la inicialización.
Si no es necesario cambiar la dirección IP según la empresa, se recomienda pasar una dirección IP unificada durante la inicialización.

Middleware・Notificación de mensajes de WeChat

Parámetros de middleware: pay<支付结果通知, 默认> refund<退款结果通知> nativePay<扫码支付模式一回调>
Debes agregar bodyParser tú mismo para recibir los datos de la publicación.
El middleware verificará la legalidad del mensaje de notificación, lo analizará en formato json y lo colocará en req.weixin(Express) o ctx.request.weixin(Koa).
respuesta () encapsulará automáticamente el mensaje de ÉXITO, respuesta ('algún error_msg') encapsulará automáticamente el mensaje de FALLO

Utilizado en expreso

 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 ) ;
} ) ;

Utilizado en Koa.

 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 ) ;
} ) ;

lista de API

Algunas API preestablecen valores predeterminados para ciertos campos obligatorios. Si no se pasan parámetros al llamar, se utilizarán los valores predeterminados.
Los parámetros que se han pasado durante la inicialización no necesitan volver a pasarse al llamar, como appid mchid
La firma se procesará automáticamente al llamar a la API, no es necesario pasarla manualmente
La cadena aleatoria (nonce_str) se procesará automáticamente al llamar a la API, no es necesario pasarla manualmente

getPayParams: obtenga los parámetros de pago de WeChat JSSDK (realización automática de pedidos, compatible con mini programas)

 let result = await api . getPayParams ( {
  out_trade_no : '商户内部订单号' ,
  body : '商品简单描述' ,
  total_fee : '订单金额(分)' ,
  openid : '付款用户的openid'
} ) ;

Valores predeterminados relacionados:

trade_type - JSAPI

getPayParamsByPrepay: obtiene los parámetros de pago de WeChat JSSDK (a través del identificador de sesión de prepago, compatible con mini programas)

 // 该方法需先调用api.unifiedOrder统一下单, 获取prepay_id;
let result = await api . getPayParamsByPrepay ( {
  prepay_id : '预支付会话标识'
} ) ;

getAppParams: Obtenga parámetros de pago de la APLICACIÓN (realización automática de pedidos)

 let result = await api . getAppParams ( {
  out_trade_no : '商户内部订单号' ,
  body : '商品简单描述' ,
  total_fee : '订单金额(分)'
} ) ;

Valores predeterminados relacionados:

trade_type -APP

getAppParamsByPrepay: obtiene los parámetros de pago de la aplicación (a través del ID de sesión de prepago)

 // 该方法需先调用api.unifiedOrder统一下单<注意传入trade_type: 'APP'>, 获取prepay_id;
let result = await api . getAppParamsByPrepay ( {
  prepay_id : '预支付会话标识'
} ) ;

getNativeUrl: escanear código para pagar (modo 1)

 let result = await api . getNativeUrl ( {
  product_id : '商品ID'
} ) ;

Escanea el código QR para pagar (modo 2)

 // 使用统一下单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'
} ) ;

micropago: pagar con tarjeta

 let result = await api . micropay ( {
  out_trade_no : '商户内部订单号' ,
  body : '商品简单描述' ,
  total_fee : '订单金额(分)' ,
  auth_code : '授权码'
} ) ;

unifiedOrder: pedidos unificados de WeChat

 let result = await api . unifiedOrder ( {
  out_trade_no : '商户内部订单号' ,
  body : '商品简单描述' ,
  total_fee : '订单金额(分)' ,
  openid : '用户openid'
} ) ;

Valores predeterminados relacionados:

trade_type - JSAPI
notify_url : el valor predeterminado es el valor pasado durante la inicialización o está vacío
spbill_create_ip : el valor predeterminado es el valor pasado durante la inicialización o 127.0.0.1

orderQuery: consultar orden

 let result = await api . orderQuery ( {
  // transaction_id, out_trade_no 二选一
  // transaction_id: '微信的订单号',
  out_trade_no : '商户内部订单号'
} ) ;

reversa: cancelar orden

 let result = await api . reverse ( {
  // transaction_id, out_trade_no 二选一
  // transaction_id: '微信的订单号',
  out_trade_no : '商户内部订单号'
} ) ;

closeOrder: cerrar orden

 let result = await api . closeOrder ( {
  out_trade_no : '商户内部订单号'
} ) ;

reembolso: Solicitar un reembolso

 let result = await api . refund ( {
  // transaction_id, out_trade_no 二选一
  // transaction_id: '微信的订单号',
  out_trade_no : '商户内部订单号' ,
  out_refund_no : '商户内部退款单号' ,
  total_fee : '订单金额(分)' ,
  refund_fee : '退款金额(分)'
} ) ;

Valores predeterminados relacionados:

op_user_id : por defecto es el número de comerciante (este campo aparece en el documento de pago del mini programa)
notify_url : el valor predeterminado es refund_url pasado durante la inicialización. Sin este parámetro, se utilizará la dirección de notificación de reembolso configurada en el backend del comerciante.

refundQuery: Consultar reembolso

 let result = await api . refundQuery ( {
  // 以下参数 四选一
  // transaction_id: '微信的订单号',
  // out_trade_no: '商户内部订单号',
  // out_refund_no: '商户内部退款单号',
  refund_id : '微信退款单号'
} ) ;

downloadBill: Descargar estado de cuenta

 /**
 * 新增一个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 ) ;

Valores predeterminados relacionados:

bill_type -TODOS
format -falso

downloadFundflow: Descargar extracto de fondos

 /**
 * 新增一个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 ) ;

Valores predeterminados relacionados:

account_type -Básico
format -falso

sendCoupon: emitir cupones

 let result = await api . sendCoupon ( {
  coupon_stock_id : '代金券批次id' ,
  partner_trade_no : '商户单据号' ,
  openid : '用户openid'
} ) ;

queryCouponStock: Consultar lotes de vales

 let result = await api . queryCouponStock ( {
  coupon_stock_id : '代金券批次id'
} ) ;

queryCouponInfo: Consultar información del cupón

 let result = await api . queryCouponInfo ( {
  coupon_id : '代金券id' ,
  openid : '用户openid' ,
  stock_id : '批次号'
} ) ;

transferencias: pagos corporativos

 let result = await api . transfers ( {
  partner_trade_no : '商户内部付款订单号' ,
  openid : '用户openid' ,
  re_user_name : '用户真实姓名' ,
  amount : '付款金额(分)' ,
  desc : '企业付款描述信息'
} ) ;

Valores predeterminados relacionados:

check_name - FORCE_CHECK
spbill_create_ip : el valor predeterminado es el valor pasado durante la inicialización o 127.0.0.1

transferenciasQuery: Consulta pagos corporativos

 let result = await api . transfersQuery ( {
  partner_trade_no : '商户内部付款订单号'
} ) ;

payBank: Pagos comerciales a tarjetas bancarias

 let result = await api . payBank ( {
  partner_trade_no : '商户内部付款订单号' ,
  bank_code : '收款方开户行' ,
  enc_bank_no : '收款方银行卡号' ,
  enc_true_name : '收款方用户名' ,
  amount : '付款金额(分)' ,
  desc : '企业付款到银行卡描述信息'
} ) ;

queryBank: Consulta pago corporativo a tarjeta bancaria

 let result = await api . queryBank ( {
  partner_trade_no : '商户内部付款订单号'
} ) ;

sendRedpack: envía paquetes rojos ordinarios

 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 : '备注信息'
} ) ;

Valores predeterminados relacionados y otras instrucciones:

mch_billno : número de pedido interno del comerciante (si se ingresa, mch_autono no será válido)
mch_autono : un número único del día de 10 dígitos, utilizado para procesar automáticamente la lógica del número de pedido interno del comerciante
total_num - 1
client_ip : el valor predeterminado es el valor del parámetro spbill_create_ip durante la inicialización o 127.0.0.1
scene_id : vacío, debe enviarse cuando el monto del sobre rojo sea superior a 2元(el documento de WeChat indica que es 200 yuanes, la medida real es 2 yuanes)

sendGroupRedpack: envía paquetes rojos de fisión

 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 : '备注信息'
} ) ;

Valores predeterminados relacionados y otras instrucciones:

mch_billno : número de pedido interno del comerciante (si se ingresa, mch_autono no será válido)
mch_autono : un número único del día de 10 dígitos, utilizado para procesar automáticamente la lógica del número de pedido interno del comerciante
total_num - 3, el valor requerido para dividir el sobre rojo está entre 3 y 20
amt_type -ALL_RAND
scene_id : vacío, debe pasarse cuando el monto del sobre rojo sea superior a 2元(no especificado en el documento)

redpackQuery: Consultar registros de paquetes rojos

 api . redpackQuery ( {
  mch_billno : '商户内部付款订单号'
} ) ;

Valores predeterminados relacionados:

bill_type -MCHT

Expandir