TinyShip 1.6.0 Released
This version introduces Alipay payment support, one of the most popular payment methods in China, enabling seamless integration for applications targeting Chinese users.
β¨ Core Additions
Alipay Provider: New payment provider implementation (libs/payment/providers/alipay.ts) using alipay-sdk
Factory & Type Updates: Payment factory and type definitions updated in libs/payment/index.ts to support Alipay
Gateway Selection: Config supports both production and sandbox gateway environments
Webhook Endpoints: Complete webhook implementations for both Next.js and Nuxt applications
π― Supported Features
| Feature | Support | Notes |
|---|---|---|
| One-time Payment | β | PC website payment (alipay.trade.page.pay) |
| Subscription | β | Not supported |
| Credits Recharge | β | Supported |
| Sandbox Testing | β | Full sandbox environment support |
π§ Technical Highlights
Alipay SDK Integration: Native alipay-sdk package for reliable payment processing
Webhook Handlers:
- Next.js:
apps/next-app/app/api/payment/webhook/alipay/route.ts - Nuxt:
apps/nuxt-app/server/api/payment/webhook/alipay.post.ts - Returns plain-text
success/failresponses as required by Alipay
UI Updates:
- Orders cards display Alipay provider in both Next.js and Nuxt dashboards
- Payment success pages skip verification for WeChat/Alipay (webhook-driven)
i18n Support: English and Chinese strings updated throughout dashboard and admin panels
π Documentation
New documentation added:
- Alipay Configuration Guide:
docs/user-guide/payment/alipay.md - Payment Overview Updated: Alipay added to supported payment methods
- Internal Guides: Payment guides reflect Alipay integration
π¦ Dependencies
- Added
alipay-sdkpackage for Alipay API integration