Skip to main content

Periodic Open Banking Payments

What are and how to integrate periodic Open Banking payments

Updated over 3 months ago

Periodic Open Banking payments let you automatically collect payments from customers on a recurring schedule (daily, weekly, or monthly) without requiring them to authorize each transaction individually.

Customers authorize the payment agreement once using Strong Customer Authentication (SCA). After that, payments are executed automatically according to the provided start date, execution frequency, and end date.

How Periodic Agreements Work

Since these payments are not processed as individual transactions through our gateway, the term Agreement is used to describe the customer's authorization to their bank.

  • The Payment Service User (PSU) agrees to a schedule of payments.

  • The agreement is managed between the PSU and their bank.

  • PSUs can modify or cancel the agreement (e.g. change amount or end date) at any time via their bank, and merchants will not be notified.

  • Merchants can cancel agreements only for LHV and Coop customers.

Retrieve Supported Payment Methods

To check which payment methods support periodic payments:

  1. Send a GET request to /processing_accounts/{account_name}

  2. Review the payment_methods.agreements_supported parameter

    • Values: "true" or "false"

Use this to filter or display only compatible payment methods to the customer.

Initiate a Periodic Payment

To start a recurring Open Banking payment:

  1. Create the agreement
    Send a POST request to /agreements with required payment details:

    • amount

    • frequency

    • start_date

    • end_date

  2. Redirect the customer
    In the response, you’ll receive:

    • A general payment_link to redirect the customer to our hosted payment page

    • A payment method-specific payment_link, if you display payment methods on your end

  3. Handle the callback
    After the customer signs the agreement, We send a callback to your specified URL with the agreement_reference.

  4. Check agreement status
    Use GET /agreements/{agreement_reference} to check the current status.

  5. Redirect the customer back
    The customer is redirected to your site where you can show the outcome of the agreement.

Tip: If you specify a payment description or structured reference, this can help you track recurring payments in bank statements.

Cancel a Periodic Payment

Merchants can cancel agreements only for LHV and Coop customers.

  1. Send a DELETE request to /agreements/{agreement_reference}

For all other banks, the customer must cancel the agreement via their online banking.

Supported Banks

Periodic Open Banking payments are supported by:

  • LHV (EE)

  • SEB (EE, LV, LT)

  • Swedbank (EE, LV, LT)

  • Coop (EE)

  • Luminor (EE, LV, LT)

  • Artea bankas (LT)

Related Articles
LinkPay Payment Link
Supported Payment Methods
Open Banking
LHV Instalment Payments
How to Test Open Banking Payments in the Demo Environment
Did this answer your question?