stripe

Implement Stripe Connect destination charges with 50/50 commission splits for marketplace payments.

Updated Oct 6, 2025
One-click install
npx skills add https://github.com/nathanielcrowell12-spec/photo-vault --skill stripe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stripe
Source: https://github.com/nathanielcrowell12-spec/photo-vault/tree/main/.claude/skills/stripe
Command: npx skills add https://github.com/nathanielcrowell12-spec/photo-vault --skill stripe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the complexity of implementing secure payment flows with automatic 50/50 commission distribution between photographers and the platform.

Core Features & Use Cases

  • Marketplace Payment Automation: Handle complex commission splits and destination charges automatically.

Core Features & Use Cases

  • Webhook Idempotency: Automatically handle duplicate payment events without creating duplicate commissions in your database.

Quick Start

Use the stripe skill to create a checkout session for a $100 photo gallery that automatically splits revenue 50/50 between the photographer and PhotoVault platform.

Frequently Asked Questions about stripe

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

FAQPage Schema
How do I split payments between photographers and a platform in a marketplace?

Stripe Connect destination charges automatically route payments to photographers while collecting a platform fee. Set up destination charges on checkout sessions with commission splits (like 50/50), configure transfer_data.destination to the photographer's connected account, and specify application_fee_amount for the platform's cut.

How do I handle duplicate payment webhook events without creating duplicate commissions?

Webhook idempotency prevents duplicate charges when payment events fire multiple times. Store webhook event IDs in your database and check for existing records before processing commissions, ensuring each payment triggers only one commission split regardless of repeated webhook calls.

What's the best way to set up Stripe Connect onboarding for photographers?

Stripe Connect onboarding integrates photographer identity verification and bank account setup directly into your platform. Use Connect onboarding flows to collect tax information and routing details, then route destination charges to verified photographer accounts for automatic payouts.

How do I handle failed payments and prevent revenue loss in a marketplace?

Dunning and failed payment handling automatically retries failed charges and notifies users. Configure retry logic in webhook handlers to catch payment failures, process refunds atomically, and trigger notifications so photographers and the platform stay informed of commission impact.

Can I use Stripe destination charges for platform subscriptions alongside marketplace payments?

Yes. Destination charges work with platform subscriptions ($22/month recurring) and one-time photo gallery sales. Configure both checkout sessions and subscription billing to apply destination charges and commission splits consistently across all payment types.

Why does my destination charge application_fee_amount calculation matter for accurate splits?

The application_fee_amount directly determines how much the platform retains from each transaction. Incorrect calculations create uneven 50/50 splits and revenue misalignment; verify the fee calculation logic in webhook handlers and checkout sessions matches your intended commission percentage.