alipay-payment-integration

Guides integration of Alipay payment products with sandbox setup and troubleshooting.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/Mozuo0w0/jimi-healthy --skill alipay-payment-integration-mozuo0w0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alipay-payment-integration
Source: https://github.com/Mozuo0w0/jimi-healthy/tree/main/frontend/jimi_frontend/.claude/skills/alipay-payment-integration
Command: npx skills add https://github.com/Mozuo0w0/jimi-healthy --skill alipay-payment-integration-mozuo0w0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Integrating Alipay payment products involves choosing the right product, configuring sandbox credentials, using the correct SDK methods, and avoiding common pitfalls like signature verification failures. This Skill walks developers through the entire process with enforced checkpoints and official documentation. ## Core Features & Use Cases - Product Selection & Integration: Routes your business scenario (in-store QR codes, H5, PC web, App, mini-program, pre-authorization, recurring billing) to the correct Alipay product and generates integration code in Java, Python, Node.js, PHP, or C#. - Automated Sandbox Setup: Creates a quick sandbox environment via the Alipay CLI, returning real appId, keys, and test accounts with strict validation. - Error Troubleshooting: Diagnoses integration errors by error code lookup and common-issue guides, including a dedicated invalid-signature investigation flow. - Use Case: A developer building an e-commerce site asks to add PC web payment; the Skill confirms the product, provisions a sandbox, generates SDK code, prints security red lines, and offers a post-integration checklist. ## Quick Start Ask the assistant to integrate Alipay payment into your project, describing your business scenario such as PC website checkout or in-store QR code collection.

Frequently Asked Questions about alipay-payment-integration

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

FAQPage Schema
How do I integrate Alipay payment into my website or app?

Describe your business scenario and the Skill routes it to the right product: PC website payment, mobile H5 payment, App payment, mini-program JSAPI payment, or in-store QR payment. It then provisions a sandbox, generates SDK code in your language, and provides a verification checklist.

Which Alipay payment product should I choose for my scenario?

Use 当面付 (face-to-face) when staff scan customer codes, order code payment for merchant-generated QR codes, App payment for native apps, JSAPI for Alipay mini-programs, WAP for mobile browsers, page pay for PC sites, pre-authorization for deposits, and merchant deduction for subscriptions.

Why does Alipay return invalid-signature during integration?

Invalid-signature most often results from incomplete request parameters, such as a missing return_url, rather than private key format problems. Check parameter completeness first, then confirm the correct key field, RSA2 sign type, and the proper gateway address.

Which private key format does the Alipay SDK require?

Java uses the appPrivateKey field in PKCS#8 format, while Python, Node.js, PHP, and .NET use appPrivatePkcsKey in PKCS#1 format. Use the sandbox-returned values directly without adding PEM headers or converting formats.

Does the Alipay quick sandbox tool work on Windows?

No, the quick sandbox CLI currently supports only macOS and Linux systems. Windows users must manually obtain sandbox credentials from the Alipay Open Platform console under Sandbox Applications.

What is the difference between pageExecute and exec in the Alipay SDK?

pageExecute is for page-redirect APIs like alipay.trade.page.pay and returns an auto-submitting HTML form, while exec is for server-side APIs like trade query and returns JSON. Calling exec on a payment API is a common integration mistake.