Payments
Payment Streams
Payment Streams are long-lived payment endpoints customers can reuse (for example tipping or open-amount collection).
Concepts
| Field | Role |
|---|---|
| Stream payment id | Identifies the stream |
| Status | ACTIVE, INACTIVE, ARCHIVED, EXPIRED |
| Amount | May be updated; customer can enter amount on the stream page depending on configuration |
Flow
- Create/manage streams in the dashboard (platform profile) or via platform APIs
- Customer opens the stream URL on hosted checkout (
/stream_payment?payment_id=...) - Engine validates stream status and redirects into the payment chooser with the amount
- Each payment creates a transaction linked to the stream’s payment group
Engine helpers include POST /long-term-payment/generate-stream-payment-url and POST /long-term-payment/check-payment-status.