wechatpay-product-coupon

Guide WeChat Pay product-coupon integration with API usage and callback handling.

323|23|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/wechatpay-apiv3/wechatpay-skills --skill wechatpay-product-coupon-wechatpay-apiv3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wechatpay-product-coupon
Source: https://github.com/wechatpay-apiv3/wechatpay-skills/tree/main/wechatpay-product-coupon
Command: npx skills add https://github.com/wechatpay-apiv3/wechatpay-skills --skill wechatpay-product-coupon-wechatpay-apiv3

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

WeChat Pay 商品券接入过程中,用户需要在“券类型选型—创建发券—回调处理—核销与状态核对—异常排障”之间快速建立正确流程与参数把控,避免漏接确认发放、签名/验签错误导致券不可用或状态不同步。

Core Features & Use Cases

  • 券类型匹配与选型指引:根据业务场景引导选择商品券三要素(适用范围/优惠类型/使用模式),覆盖常见券类型组合。
  • 官方接口接入示例检索:按接入模式(品牌直连/服务商)、开发语言(仅维护 Java/Go 示例)与目标接口提供“只检索不生成”的示例代码与使用规范。
  • 业务知识速查:覆盖券创建、发券、确认发放、核销、退券、券状态流转与参数获取等关键知识点,并结合接入质量检查与回调处理要求。
  • 接入质量评估与接口排障:对签名验签、业务逻辑完整性与回调处理规范做上线前核查;针对报错/回调异常按错误码与手册流程给出排查步骤,并支持通过脚本查询券详情辅助诊断。

Quick Start

Ask the skill to help me接入 WeChat Pay 商品券:先确认我是品牌直连还是服务商、我的开发语言是 Java 还是 Go,然后给出“查询用户商品券详情”的接口代码示例并说明如何校验券状态。

Frequently Asked Questions about wechatpay-product-coupon

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

FAQPage Schema
How do I integrate WeChat Pay product coupon APIs for brand-direct or service-provider scenarios?

WeChat Pay product coupon integration requires mapping your access mode, selecting coupon types, and applying correct API signatures. The workflow guides you through creating, sending, confirming, redeeming, and querying coupons end-to-end to prevent state desync.

Why does my WeChat Pay product coupon callback fail state synchronization and show wrong statuses?

WeChat Pay product coupon callback failures usually stem from missing confirm-before-use workflows or incorrect signature verification. You must enforce strict interaction guardrails and handle callback confirmations properly to keep coupon states synchronized.

How to troubleshoot WeChat Pay product coupon errors using Java or Go official examples?

Troubleshooting WeChat Pay product coupon errors involves querying coupon details via scripts and matching error codes against official manuals. The skill retrieves Java or Go official examples without generating code to help diagnose failures accurately.

What is the correct workflow for WeChat Pay product coupon creation, confirmation, and redemption?

The correct WeChat Pay product coupon workflow spans selecting coupon elements, creating coupons, sending, confirming issuance, and redeeming. Applying strict confirm-before-use guardrails ensures signatures are verified and states transition correctly before redemption.

Do I need to verify API signatures before querying WeChat Pay product coupon details?

Verifying API signatures is mandatory before querying WeChat Pay product coupon details or handling callbacks. Enforcing correct signing and verification prevents unauthorized access and ensures your integration passes pre-launch quality checks.

What are the limitations when retrieving WeChat Pay product coupon integration examples?

WeChat Pay product coupon example retrieval is limited to Java and Go official examples only, without generating custom code. The system strictly retrieves existing examples and does not support other programming languages.