通知

使用之前，请先参考入门

在JSSDK、小程序、APP、H5等平台支付完成之后，微信都会向服务端发起一个支付成功通知给到商户端。

处理通知回调

在PowerWechat里，处理通知只需要调用一个PaymentService.HandlePaidNotify即可。 至于证书签名验证、RSA解密等，通通不需要。

  1. res, err := services.PaymentApp.HandlePaidNotify(
  2.   c.Request,
  3.   func(message *request.RequestNotify, transaction *models.Transaction, fail func(message string)) interface{} {
  5.     // 看下支付通知事件状态
  6.     // 这里可能是微信支付失败的通知，所以可能需要在数据库做一些记录，然后告诉微信我处理完成了。
  7.     if message.EventType != "TRANSACTION.SUCCESS" {
  8.       return true
  9.     }
  11.     if *transaction.OutTradeNo != "" {
  12.       // 这里对照自有数据库里面的订单做查询以及支付状态改变
  13.       log.Printf("订单号：%s 支付成功", transaction.OutTradeNo)
  14.     } else {
  15.       // 因为微信这个回调不存在订单号，所以可以告诉微信我还没处理成功，等会它会重新发起通知
  16.       // 如果不需要，直接返回true即可
  17.       fail("payment fail")
  18.       return nil
  19.     }
  20.     return true
  21.   },
  22. )
  24. // 这里可能是因为不是微信官方调用的，无法正常解析出transaction和message，所以直接抛错。
  25. if err != nil {
  26.   panic(err)
  27. }
  29. // 这里根据之前返回的是true或者fail，框架这边自动会帮你回复微信
  30. err = res.Write(c.Writer)
  32. if err != nil {
  33.   panic(err)
  34. }
  1. // 其他支付通知的回调通知
  2. func (app *Payment) HandlePaidNotify(request *http.Request, closure func(message *request.RequestNotify, transaction *models.Transaction, fail func(message string)) interface{}) (*response.HttpResponse, error) {
  3.     return notify.NewPaidNotify(app, request).Handle(closure)
  4. }
  6. func (app *Payment) HandleRefundedNotify(request *http.Request, closure func(message *request.RequestNotify, transaction *models.Refund, fail func(message string)) interface{}) (*response.HttpResponse, error) {
  7.     return notify.NewRefundNotify(app, request).Handle(closure)
  8. }
  10. func (app *Payment) HandleScannedNotify(request *http.Request, closure func(message *request.RequestNotify, fail func(message string), alert func(message string)) interface{}) (*response.HttpResponse, error) {
  11.     return notify.NewScannedNotify(app, request).Handle(closure)
  12. }

注意:

  • 同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
  • 推荐的做法是，当商户系统收到通知进行处理时，先检查对应业务数据的状态，并判断该通知是否已经处理。
    • 如果未处理，则再进行处理；
    • 如果已处理，则直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
  • 如果在所有通知频率后没有收到微信侧回调，商户应调用查询订单接口确认订单状态。

至于官方文档中提到的签名验证， PowerWechat已经帮你做好了签名验证的工作，确保回调是来自微信官方的合法签名。

官方文档： https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_1_5.shtml