Integrate Payment Gateway — Stripe API v3 Upgrade

To Do

Set up Webhook retry queue for failed events

Design fraud detection rules for high-value txns

Write unit tests for refund processing module

Audit PCI-DSS compliance checklist

In Progress

Integrate Payment Gateway — Stripe API v3 Upgrade

Implement 3DS2 strong authentication flow

Migrate legacy Braintree integrations to new SDK

In Review

Payment confirmation email template update

Currency conversion API — edge case handling

Done

Remove deprecated Stripe v2 token endpoints

Upgrade stripe-node SDK to 14.x

Refactor checkout flow state machine

LABELS MEMBERS DUE DATE

Payments

High Priority

Backend

Apr 14, 2026 at 5:00 PM

≡ Description

Objective: Migrate our checkout pipeline from the deprecated Stripe API v2 to the new v3 SDK (stripe-node 14.x). This unlocks PaymentIntents, SetupIntents, and automatic currency conversion.

Scope:

Replace stripe.charges.create() with stripe.paymentIntents.create() across all service endpoints
Update webhook signature verification to use stripe-signature header (v3 format)
Refactor subscription billing handlers for the new Subscription object shape
Smoke test against Stripe test-mode sandbox before promoting to staging

Acceptance Criteria: All unit and integration tests pass. Zero failed charge events in Stripe dashboard test-mode for 48 hrs. PR reviewed by at least 2 engineers.

🤖

Butler Automation Rule triggered Apr 3, 2026 at 09:14

Auto-linked from Sprint 14 planning board. Label "High Priority" applied. Review required before Apr 14.

{fill}

📎 Attachments

PDF

stripe-v3-migration-guide.pdf

Added Apr 1, 2026 · 2.4 MB

Edit Delete Make cover

PNG

payment-flow-diagram-v3.png

Added Apr 2, 2026 · 340 KB

Edit Delete Make cover

XLS

api-endpoint-mapping-v2-to-v3.xlsx

Added Apr 2, 2026 · 88 KB

Edit Delete Make cover

☑

Migration Checklist 60%

✓

Upgrade stripe-node to 14.x in package.json

✓

Replace all stripe.charges.create calls with stripe.paymentIntents.create

✓

Update webhook signature verification middleware

Refactor subscription billing handlers (3 services remaining)

Run full regression suite against Stripe test-mode sandbox

Submit PR for engineering review (min 2 approvals required)

Deploy to staging; monitor Stripe dashboard for 48 hrs

💬 Activity

Write a comment…

Priya Shah Apr 3, 2026 at 3:47 PM

Checked the endpoint mapping sheet — looks like /v1/charges is also called from invoice-service and wallet-service. Adding those to the checklist scope. @Alex can you double-check the webhook handler in payment-gateway-service/src/webhooks/stripe.js? The signature validation logic may need updating too.

Edit · Delete · React

Alex Kim Apr 3, 2026 at 5:02 PM

Good catch, Priya. I've updated the checklist. The stripe.js webhook handler already uses the v3 stripe-signature header but I'll add a regression test to confirm. Expecting to have subscription handlers done by EOD tomorrow.

Edit · Delete · React