Stripe Payment Adapter

amerta


amerta / Stripe Payment Adapter

Stripe Payment Adapter

Title

Stripe Payment Adapter

Description

This adapter implements the PaymentAdapter interface to handle credit card payments via Stripe. It supports both frontend (Client Secret) and backend payment processing with automatic webhook setup.

Features

  • PCI-compliant credit card processing
  • Support for multiple payment methods (cards, wallets, etc.)
  • Automatic webhook creation and management
  • Multi-currency support with zero-decimal currency handling
  • Duplicate transaction detection
  • Server-side payment intent management
  • Currency conversion with exchange rates

Configuration

  • slug: "stripe"
  • label: "Credit Card (Stripe)"
  • Settings: Publishable key, secret key, webhook ID, webhook secret

Payment Flow

  1. Frontend creates/updates payment intent using client secret
  2. User completes payment on frontend with Stripe Elements
  3. Stripe sends webhook to confirm payment
  4. Backend processes webhook, verifies transaction, and updates order
  5. User is redirected to order confirmation page

Webhook Events Handled

  • payment_intent.succeeded - Payment successfully completed
  • payment_intent.payment_failed - Payment failed
  • charge.refunded - Payment refunded

Variables