Payment Flow
Understand the complete payment lifecycle
Overview
A payment goes through several states from creation to completion. Understanding this flow is essential for building a robust integration.
Payment States
CREATED->PROCESSING->REQUIRES_ACTION->SUCCEEDED
| State | Description |
|---|---|
CREATED | Payment intent has been created, awaiting payment method |
PROCESSING | Payment is being processed with the provider |
REQUIRES_ACTION | Additional action required (e.g., 3DS, redirect) |
SUCCEEDED | Payment completed successfully |
FAILED | Payment failed (terminal state) |
CANCELED | Payment was canceled (terminal state) |
Typical Flow
- Create Payment Intent: Your server creates a payment intent with the amount and currency.
- Collect Payment Method: The user selects a payment method from the available options.
- Proceed with Payment: Your server submits the payment to our API.
- Handle Redirects: If 3DS or bank authentication is required, the user is redirected.
- Confirm Result: The payment completes and you receive a webhook notification.
Content Coming Soon
Detailed sequence diagrams and flow charts will be added in Phase 2.