A periodic Open Banking payment functionality allows merchants to automatically collect payments from customers on a regular basis (daily, weekly, monthly) without requiring customers to manually authorize each transaction. Payments are initiated and authorized using Strong Customer Authentication (SCA) only once, after which they are executed at regular intervals based on the provided start date, execution frequency, and end date.
Since there are no active payments processed through our payment gateway, the term ‘Agreement’ is introduced to describe the process by which the Payment Service User (PSU) provides authorization to be debited by their bank in accordance with the details of the periodic payment.
Please also note that as the Agreement is signed between the PSU and their bank, it is possible that the PSU edits the Agreement details (amount, end date) or cancels the Agreement, and the merchant will not be notified of these changes. The merchant themself can only cancel the Agreements with LHV and Coop PSU-s.
To take the functionality into use, please contact your bank representative or send an email to kmg@seb.ee (EE), ecommerce@seb.lv (LV), or eprekyba@seb.lt (LT). You will be asked to sign an agreement appendix before this functionality will be enabled to you.
Fetch the payment methods that support periodic Open Banking payments
If you are displaying the available payment methods on your side before initiating a periodic payment, the payment methods that support this feature can be retrieved by using a GET request to /processing_accounts/{account_name}. You can check the “payment_methods.agreements_supported” parameter, where possible values are “true” or “false”.
Initiate periodic Open Banking payment
1. Make a POST /agreements request including all the required payment details. This should specify the amount to be debited from the customer, along with key information such as the “frequency”, “start_date”, and “end_date” for the periodic payments
2. In the response, a general “payment_link” will be returned, which should be used to redirect the customer to our hosted payment page, allowing them to select a payment method. Additionally, a payment method-specific “payment_link” will be provided if you are displaying the available payment methods on your side
3. After the PSU completes the signing of the periodic payment agreement, a callback notification is sent to the merchant’s specified callback URL. This notification contains the “agreement_reference” parameter, indicating that the status of the agreement has changed
4. To check the status of the agreement, make a GET /agreements/{agreement_reference} request
5. The PSU is redirected back to the merchant, where the outcome of the agreement is displayed
Note that if payment description and/or structured reference is specified, this information can be used for tracking the periodic payments from bank account statements.
Delete periodic Open Banking payment
The merchant can use this functionality to stop receiving future payments from a PSU with an existing periodic payments agreement. However, note that not all PSU banks support this feature. At this time, only LHV and Coop support this feature. To cancel the periodic payments, the PSU must cancel the agreement through their online banking platform.
1. Make a DELETE /agreements/{agreement_reference} request to cancel a previously successfully signed periodic payment agreement
Supported banks
- LHV (EE)
- SEB (EE, LV, LT)
- Swedbank (EE, LV, LT)
- Coop (EE)
- Luminor (EE, LV, LT)
- Šiaulių bankas (LT)
