alipay-payment-integration

Route Alipay integration requests to payment products with API and SDK guidance.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/augustscl/awesome-xiawang-skills --skill alipay-payment-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alipay-payment-integration
Source: https://github.com/augustscl/awesome-xiawang-skills/tree/main/alipay-payment-integration
Command: npx skills add https://github.com/augustscl/awesome-xiawang-skills --skill alipay-payment-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many teams struggle to choose and integrate the correct Alipay payment product because Alipay offers multiple acquisition methods (App, H5, JSAPI, PC, face-to-face, pre-authorization, and merchant deduction) with different APIs, endpoints, and signing rules; this Skill maps business scenarios to the right product and explains the integration steps and pitfalls so integrations succeed quickly and safely.

Core Features & Use Cases

  • Product routing: Clear mapping from business scenario to recommended Alipay product and core API names (e.g., alipay.trade.app.pay, alipay.trade.precreate, alipay.trade.wap.pay).
  • Integration guidance: Practical advice on signing (RSA2), sandbox vs production gateways, recommended server SDKs, common traps, and testing recommendations.
  • Documentation-first workflow: Encourages fetching and referencing Alipay's live online docs for accurate parameters and examples; includes curl-based retrieval patterns and recursive link fetching.
  • Use case examples: App payments with RSA2, H5 payment fallbacks, JSAPI (mini-program) flows, offline face-to-face payments (扫码/付款码), pre-authorization for deposits, and recurring merchant deductions.

Quick Start

Use this skill to identify the correct Alipay product for your scenario and generate step-by-step server and client integration instructions with RSA2 signing and sandbox test guidance.

Frequently Asked Questions about alipay-payment-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the right Alipay payment API for my business scenario?

Alipay integration requires mapping your scenario to the correct product, such as alipay.trade.app.pay for apps or alipay.trade.precreate for face-to-face payments. This routing ensures you call the proper gateway endpoint and apply the correct integration steps.

What is the correct way to sign Alipay payment requests?

Alipay integration uses RSA2 signing for secure payment requests. You must apply RSA2 signatures when calling gateway endpoints, utilizing recommended server SDKs to handle the signing logic and avoid common implementation traps.

How do I test Alipay payments before going to production?

Alipay integration testing uses sandbox endpoints to simulate payment flows safely. You can validate your App, H5, or JSAPI payment implementation against the sandbox environment before switching gateway URLs to production.

Does Alipay pre-authorization work for deposit scenarios?

Alipay pre-authorization supports deposit scenarios by holding funds before capturing them later. This integration maps to a specific pre-authorization product, providing the correct API names and gateway URLs for your server and client implementation.

Why does my H5 payment integration need a fallback flow?

H5 payment integration requires fallback flows because some mobile browsers do not support the default payment redirect. Mapping this scenario to the alipay.trade.wap.pay API provides the correct integration guidance for handling these client-side limitations.

Can I use Alipay JSAPI payments outside of mini-programs?

Alipay JSAPI payments are designed for mini-program flows and require a specific integration approach. Routing this scenario to the correct JSAPI product supplies the proper API names and client SDK usage recommendations for successful integration.