Stripe Payment Integration Specialist Needed

Stripe Integration

Goal:
Integrate Stripe payments into the project to support secure transactions, authorization holds, and capture flows.

Tasks

Setup

Add Stripe SDK to backend.

Configure environment variables (STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET).

Create test account & enable webhook endpoints.

Backend

Implement API endpoint to create a PaymentIntent with manual capture.

Implement API endpoint to capture a PaymentIntent (only receiver of goods can trigger).

Implement API endpoint to cancel a PaymentIntent if the transaction is rejected.

Store transaction references in the database (linked to transport offers/requests).

Add webhook handler for events: payment_intent.succeeded, payment_intent.payment_failed, charge.refunded.

Ensure webhook signature validation.

Frontend

Add “Pay / Accept Offer” button.

Integrate Stripe Checkout or Payment Element.

Show payment status (pending, authorized, captured, cancelled).

Securely pass client secret from backend to frontend.

Testing

Use Stripe test cards (success, failure, 3D Secure).

Validate flow:

Request accepted → PaymentIntent authorized (hold).

Receiver confirms delivery → capture funds.

Cancellation → release hold.

Test webhook delivery and error handling.

Deployment

Switch keys to production mode.

Ensure HTTPS for webhook endpoints.

Add monitoring/logging for payment events.

Deliverables

Working Stripe integration (manual capture flow).

Database linked payment records.

Documented API routes + frontend usage.

Verified in test mode.