\r \r

a2a-Market Stripe Payment\r

\r Create the Stripe payment integration skeleton for order settlement.\r \r Current status: registration scaffold with stable payment contracts and webhook map.\r \r

Scope\r

• Create payment intent from negotiated order terms.\r
• Capture or cancel payments based on order transitions.\r
• Reconcile webhook events with internal order state.\r \r

Suggested Project Layout\r

• app/integrations/stripe/stripe_client.py\r
• app/application/services/payment_service.py\r
• app/interfaces/api/payment_routes.py\r
• app/infrastructure/tasks/stripe_webhook_worker.py\r \r

Minimum Contracts (MVP P0)\r

1. create_payment_intent(order_id, amount, currency) returns provider intent id + client secret.\r
2. capture_payment(provider_intent_id) captures authorized funds.\r
3. cancel_payment(provider_intent_id) voids uncaptured authorization.\r
4. handle_webhook(event) verifies signature and upserts payment status.\r \r

Event Mapping\r

• Emit ORDER_CREATED when payment intent is created.\r
• Emit PAYMENT_SUCCEEDED when capture confirms.\r
• Emit payment-failed incident event when authorization/capture fails.\r \r

Guardrails\r

• Verify webhook signature before parsing payload.\r
• Enforce idempotency key for create/capture endpoints.\r
• Keep provider status mapping table explicit and versioned.\r \r

Implementation Backlog\r

• Add partial refund and dispute webhook handling.\r
• Add multi-currency routing and fee optimization.\r \r

Runtime Implementation\r

• Status: implemented in local runtime package.\r
• Primary code paths:\r
• runtime/src/integrations/stripe/stripe-payment-service.js\r
• Validation: covered by runtime/tests and npm test in runtime/.\r