Single Immediate
Payment Flow
Notice for Merchants with Existing Payment Plan Single Immediate IntegrationAt UAT from 4th of August the IntermediateFrontend and along with it displaying the spinner will disappear. Our returnURL will already be triggered once the consent request reached a final status. From this time on, also new merchants will be boarded without the IntermediateFrontend.
Endpoints
| Action | Endpoint |
|---|---|
| Request Payment | POST /payments |
| Retrieve Consent | GET /consents |
| Retrieve Authorization | GET /authorizations |
| Retrieve Capture | GET /captures |
| Make Refund | POST /{paymentId}/refunds |
| Retrieve Refund | GET /{paymentId}/refunds |
Description
A Single Immediate Payment is a one-time payment that is created and executed instantly once the payment consent is successfully granted by the payer and the payment authorization is authorized by his bank.. The full transaction amount is debited in real time, and the merchant receives an immediate confirmation of success or failure.
Typical use cases/scenarios
- Merchant provides a single product or service to be paid immediately
- Example: online purchase, ticketing, digital content
- The payer makes an one-off donation or contribution
- Example: charity
- The business model requires instant settlement confirmation to proceed
- Example: issuing access codes, delivering goods, proceeding with service
Key characteristics
- Use Case: SINGLE
- Lifecycle: PENDING → SUCCESSFUL/FAILED
- Authorization: The payer bank confirms the payment in real time
- Timeouts: A payment session remains valid only for a limited period of time (10 minutes). If the payer doesn't complete the payment flow and approves the payment consent, the payment expires.
Recommendations
- When using Wero, it is recommended to perform the status check multiple times (or long polling), since — for technical reasons — it can occasionally take more than just a few seconds until a payment capture is successfully completed.
- Merchants should not delete transactions that appear to be stuck in a pending capture status. Instead, if the merchant wishes to discontinue with the payment, such transactions should be cancelled properly.
Merchant benefits:
Simplicity: easy to implement, minimal data required.
Certainty: immediate response on success/failure, near-time settlements
Customer experience: instant checkout completion.
Updated about 2 months ago