# wechatpay-apiv3/wechatpay-java

微信支付 APIv3 的官方 Java Library

Repository: https://github.com/wechatpay-apiv3/wechatpay-java
Canonical: https://ross.abutalabs.com/products/wechatpay-java
Language: Java
License: Apache-2.0
License Family: permissive
Topics: java, sdk, wechatpay, weixin, weixin-pay, api-library, payment, wechatpay-apiv3
Last push: 2025-04-11T13:38:28+00:00

## Health v2 (maintenance only)
Score: 37/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 16, release rhythm 28, longevity 100
- inputs: {"age_days": 1556, "days_push": 509, "days_rel": 509, "gap_med": 71.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1541, forks 299 (observed 2026-08-28T04:05:00.682764+00:00)

## What it is
The official Java SDK for WeChat Pay APIv3, consisting of a core library with automatic request signing, response verification, callback handling, and encryption/decryption, plus service modules for business APIs like Native Pay. It is published on Maven Central and requires Java 1.8+ and a WeChat Pay merchant account.

## Use cases
- integrate wechat pay into a java backend
- create native pay prepay orders from java
- verify and decrypt wechat pay callback notifications
- handle wechat pay api request signing automatically
- download wechat pay platform certificates
- process refunds via wechat pay api
- query payment and order status from wechat pay

## When to choose
- you are a Java developer building payments for a WeChat Pay merchant account
- you want an official, maintained SDK with automatic signing and signature verification
- you need typed service clients for WeChat Pay business APIs instead of raw HTTP calls

## When to avoid
- your application is not in Java or on the JVM
- you need WeChat Pay APIv2 (this SDK only covers APIv3)
- you use another payment provider such as Alipay or Stripe

## Facets
- artifact type: library
- maturity: active
- function: sdk, http-client, cryptography, auth
- domain: fintech, e-commerce, apis, developer-tools
- platform: jvm, cross-platform
- tags: wechat-pay, payment-gateway, apiv3, official-sdk, signature-verification, callback-handling

## Member repositories
- wechatpay-apiv3/wechatpay-java (main) score 37

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:00.682764+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:30:49.058957+00:00, confidence not recorded.
  - readme: https://github.com/wechatpay-apiv3/wechatpay-java (fetched 2026-08-28T04:05:00.682764+00:00, sha 6fb2ca686b9c)
- Data as of 2026-08-30T08:39:29.467469+00:00.
