payment-integration

Implement PCI-compliant payment gateway integration with tokenization, idempotent charging, and webhook verification.

150|48|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/irahardianto/awesome-agv --skill payment-integration-irahardianto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: payment-integration
Source: https://github.com/irahardianto/awesome-agv/tree/main/.agents/skills/payment-integration
Command: npx skills add https://github.com/irahardianto/awesome-agv --skill payment-integration-irahardianto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the risk of insecure, non-compliant, and unreliable payment implementations that can lead to PCI violations, double charges, broken subscriptions, and unsafe webhook processing.

Core Features & Use Cases

  • PCI DSS & security fundamentals: Enforces tokenization, TLS-only transport, minimal retention, and safe logging practices for payment credentials.
  • Reliable transaction patterns: Provides idempotency guidance to prevent duplicate charges and supports correct authorization/capture/void/refund flows.
  • Webhook & subscription correctness: Recommends signature verification, idempotent asynchronous webhook handling, and a structured subscription lifecycle with dunning and proration.

Quick Start

Use this skill to design a Stripe (or Adyen) payment integration that is PCI-safe, retry-safe with idempotency, and webhook-verified while covering subscriptions, refunds, and fraud controls.

Frequently Asked Questions about payment-integration

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

FAQPage Schema
How do I implement idempotent charging to prevent duplicate payments?

Idempotent charging prevents duplicate payments by using unique idempotency keys for each transaction request. This ensures that if a network timeout or retry occurs, the payment gateway processes the charge only once, avoiding double charges and maintaining payment reliability.

What is card tokenization and how does it help with PCI DSS compliance?

Card tokenization replaces sensitive payment credentials with secure tokens, helping achieve PCI DSS compliance through minimal data retention. By avoiding raw card storage and enforcing TLS-only transport, systems prevent PCI violations while maintaining safe logging practices.

How do I verify webhook signatures for payment gateway notifications?

Webhook signature verification validates payment gateway notifications cryptographically to prevent tampering. Combined with idempotent asynchronous webhook handling, it ensures reliable processing of subscription billing events and transaction updates without duplicate execution.

Does this payment integration approach support subscription billing lifecycle management?

Yes, the payment integration supports subscription billing lifecycle management through a structured approach. It includes dunning for failed payment retries, proration for mid-cycle changes, and fraud controls like 3D Secure and AVS to secure recurring transactions.

What's the best way to handle authorization, capture, void, and refund flows?

Handling authorization, capture, void, and refund flows requires correct sequencing of payment gateway API calls. Using idempotency keys during these transaction states ensures reliability, preventing duplicate charges or errors during network failures.

Can I use this to build a PCI-compliant integration with Stripe or Adyen?

Yes, you can build a PCI-compliant integration with Stripe or Adyen using this approach. It provides guidance for tokenization, minimal retention, and fraud controls required to satisfy PCI DSS requirements for secure payment processing.