Integration example
A realistic walkthrough of building a PSE collector for e-commerce.
This page walks through a representative Banking integration end-to-end: a PSE collector for e-commerce. You will see the full path from a customer clicking "pay" in your checkout to your system marking the order as paid and shipping the goods.
PSE collection is the most common Banking use case. The same pattern transfers to invoice settlement, subscription top-ups, and any payer-initiated payment.
This page is an integration-example scaffold. The full version will include code per step (curl, Node.js, Python), a sequence diagram, error handling, and reconciliation patterns.
What you will build
An e-commerce checkout that:
- Generates a PSE collection link when the customer chooses "pay with bank account".
- Redirects the customer to PSE for bank selection and authorization.
- Receives a webhook when the bank confirms the payment.
- Marks the order as paid and triggers fulfillment.
- Handles the failure cases — abandoned, expired, declined.
Architecture
| Layer | Component |
|---|---|
| Frontend | Checkout UI, redirect to PSE, return-URL handling |
| Backend | Collection-link creation, webhook receiver, order state machine |
| Mono | Banking API + collection-link webhooks |
| External | PSE network + customer's bank |
Walkthrough
The full walkthrough is pending. Until it is published, see: