การนำเข้าแพ็คเกจ:
< dependency >
< groupId >me.hao0</ groupId >
< artifactId >wepay-core</ artifactId >
< version >1.3.2</ version >
</ dependency >
แพ็คเกจที่ต้องพึ่งพา ให้ความสนใจว่าคุณจำเป็นต้อง แยกออก เมื่อแนะนำโปรเจ็กต์หรือไม่:
< dependency >
< groupId >me.hao0</ groupId >
< artifactId >common</ artifactId >
< version >1.1.2</ version >
</ dependency >
การใช้งานขั้นพื้นฐาน:
Wepay wepay = WepayBuilder
. newBuilder ( appId , appKey , mchId )
. config1 (...) // 其他可选配置
...
. build ();
wepay . module (). api ();
ส่วนประกอบที่นำไปใช้:
pay()
;refund()
;order()
;notify()
;bill()
.เอกสาร API ที่นี่
เกี่ยวกับการทดสอบ :
กรณีทดสอบประกอบด้วยการทดสอบพื้นฐานบางอย่างที่ต้องมีการกำหนดค่าบางอย่าง:
// 在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 ();
โปรเจ็กต์ wepay-demo เป็นโปรเจ็กต์เว็บที่รันได้ ซึ่งสะดวกสำหรับการทดสอบ คุณสามารถทดสอบได้ตามขั้นตอนต่อไปนี้ คัดลอก app-example.properties
ใน wepay-demo ไปยัง app.properties
และกำหนดค่าตามนั้น:
# 微信app id
appId =
# 微信支付key
appKey =
# 商户号
mchId =
# 支付通知url
payNotifyUrl = $ { your_domain } / notifies / paid
หมายเหตุ : ** payNotifyUrl
** ควรกำหนดค่าเป็นที่อยู่ที่เซิร์ฟเวอร์ WeChat สามารถโทรจากเครือข่ายภายนอกได้ สำหรับการทดสอบในพื้นที่ ขอแนะนำให้ใช้เครื่องมือ ngrok สำหรับการแมปเครือข่ายท้องถิ่นและภายนอก
ไปที่ไดเร็กทอรีราก wepay-demo และรันคำสั่งต่อไปนี้:
mvn clean jetty:run -Dmaven.test.skip -Djetty.port={自定义端口号}
สามารถเข้าถึงการชำระเงินด้วยรหัส QR แบบไดนามิกได้ ( หลังจากที่คำขอเป็นเรื่องปกติ รูปภาพรหัส QR ที่สร้างโดย Liantu จะปรากฏขึ้น หลังจากการชำระเงินสำเร็จด้วยการสแกนด้วย WeChat Notifies
เตือนที่เกี่ยวข้องจะได้รับการแจ้งเตือนในพื้นหลัง ):
http://localhost:{port}/pays/qrpay ? orderNumber={自定义订单号}
สามารถขอคืนเงินได้ ( หลังจากส่งสำเร็จ จะมีข้อความแจ้งเตือนบน WeChat ):
http://localhost:{port}/refunds/apply ? orderNumber={商户订单号} ` ` `
เอกสารที่เกี่ยวข้อง:
เวอร์ชันประวัติศาสตร์:
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
เป็น clientIp
ส่วนประกอบที่เกี่ยวข้อง:
อาลีเพย์:
วีแชท: