Impor paket:
< dependency >
< groupId >me.hao0</ groupId >
< artifactId >wepay-core</ artifactId >
< version >1.3.2</ version >
</ dependency >
Paket dependen, perhatikan apakah Anda perlu mengecualikan saat memperkenalkan proyek:
< dependency >
< groupId >me.hao0</ groupId >
< artifactId >common</ artifactId >
< version >1.1.2</ version >
</ dependency >
Penggunaan dasar:
Wepay wepay = WepayBuilder
. newBuilder ( appId , appKey , mchId )
. config1 (...) // 其他可选配置
...
. build ();
wepay . module (). api ();
Komponen yang diterapkan:
pay()
;refund()
;order()
;notify()
;bill()
.Dokumentasi API di sini.
Tentang pengujian :
Kasus pengujian mencakup beberapa pengujian dasar yang memerlukan beberapa konfigurasi:
// 在test/reources目录中配置dev.properties
// 包括appId(APP ID), appKey(支付密钥), mchId(商户号)
Properties props = new Properties ();
InputStream in = Object . class . getResourceAsStream ( "/dev.properties" );
props . load ( in );
in . close ();
// 配置证书,退款需要证书,不配置可测试除退款的接口
Path path = Paths . get ( "/path/to/your_cert.p12" );
byte [] data = Files . readAllBytes ( path );
wepay = WepayBuilder . newBuilder (
props . getProperty ( "appId" ),
props . getProperty ( "appKey" ),
props . getProperty ( "mchId" ))
. certPasswd ( props . getProperty ( "mchId" ))
. certs ( data )
. build ();
Proyek wepay-demo adalah proyek web yang dapat dijalankan, yang nyaman untuk pengujian. Anda dapat mengujinya sesuai dengan langkah-langkah berikut. Salin app-example.properties
di wepay-demo ke app.properties
dan konfigurasikan sesuai:
# 微信app id
appId =
# 微信支付key
appKey =
# 商户号
mchId =
# 支付通知url
payNotifyUrl = $ { your_domain } / notifies / paid
Catatan : ** payNotifyUrl
** harus dikonfigurasi sebagai alamat yang dapat dihubungi oleh server WeChat dari jaringan eksternal. Untuk pengujian lokal, disarankan untuk menggunakan alat ngrok untuk pemetaan jaringan lokal dan eksternal.
Buka direktori root wepay-demo dan jalankan perintah berikut:
mvn clean jetty:run -Dmaven.test.skip -Djetty.port={自定义端口号}
Pembayaran kode QR dinamis dapat diakses ( setelah permintaan normal, gambar kode QR yang dihasilkan oleh Liantu akan muncul. Setelah pembayaran berhasil dengan memindai dengan WeChat, Notifies
terkait akan diterima di latar belakang ):
http://localhost:{port}/pays/qrpay ? orderNumber={自定义订单号}
Pengembalian dana dapat diakses ( setelah pengiriman berhasil, sebuah pesan akan diberitahukan di WeChat ):
http://localhost:{port}/refunds/apply ? orderNumber={商户订单号} ` ` `
Dokumen terkait:
Versi sejarah:
1.0.0:
1.1.0:
1.1.1:
1.1.2:
1.2.2:
1.2.3:
1.2.4:
1.2.5:
1.3.0:
1.3.1:
goods_tag
.1.3.2:
clientIp
ke clientIp
.Komponen terkait:
Alipay:
Wechat wechat: