The Scenario
A global e-commerce business relies on Stripe to process customer payments. When a payment completes, Stripe sends a webhook callback notification to the merchant system to trigger order fulfillment. The Business Analyst must write a detailed system integration specification so the engineering team can build the webhook receiver endpoint (`/api/webhooks/stripe-payments`).
The Brief
Write the webhook integration specification. Define the webhook event type (`payment_intent.succeeded`), outline the incoming payload structure (in USD), document the endpoint authentication method (webhook signature verification), and model the error/retry handling workflow.
Deliverables
- Stripe webhook payload JSON schema (covering payment intent ID, customer ID, amount in USD, transaction status, metadata).
- Interface interaction diagram showing the flow between Customer, Stripe, and the Merchant endpoint.
- Detailed API response status code mappings (e.g. 200 OK, 400 Bad Request, 401 Unauthorized, 500 Server Error).
- A retry and idempotency policy to prevent double-processing orders if Stripe retries a delivery.
Submission Guidance
Deliver your specification in Markdown. Include JSON samples and response schemas. Draw the interaction sequence using a text-based or mermaid flowchart.
Submit Your Work
Your submission is graded against the rubric on the right. If you pass, you get a public Badge URL you can share on LinkedIn. There is no draft save, so work offline first and paste your finished response here.