Making SEPA Credit payments

Available in: 🇪🇺 EU, 🇬🇧 UK
Supported currencies: EUR, GBP
Supported payer (entity) countries: Belgium, Ireland, Italy, Netherlands, UK

Overview

SEPA Credit Transfer (SCT) is a payment method used for cross-border and domestic Euro payments within the Single Euro Payments Area (SEPA) region. Both the sender and the recipient can be companies or individuals.

Use cases

SEPA Credit is one of the payment methods available for Monite payment links. Entities can use payment links to both send and receive SEPA Credit payments.

BillPay (pay payables)

1. Entity receives a payable from its counterpart (vendor or supplier).
2. The partner’s application enables entity users to view the available payables, along with the “pay” option for unpaid payables.
3. When an entity user chooses to pay a payable, the application generates a payment link ID for that payable and uses that ID to initialize the embedded Payment Web Component.
4. The payment component displays the payment details (amount, recipient, due date, etc.) and the available payment methods.
5. To pay via SEPA Credit, the entity user selects “Bank transfer” as the payment method and provides consent to withdraw the payment amount from the entity’s bank account.
6. Monite initiates the payment with the entity’s bank.
7. After the payment request is accepted by the entity’s bank, the funds are transferred via SEPA Credit to the counterpart bank account specified in the payable.

Requirements

From an integration perspective, using SEPA Credit requires the following from Monite partners:

• Server side - to generate payment links, receive webhooks about the payment status, and (optionally) customize the look and feel of the payment page.
• Client side - you can use either Monite-hosted payment page (optionally masked with your own domain), or an embeddable Payment component.

Additionally:

• Both the payer (entity) and the recipient (counterpart) must be based in the EU or UK.
• If the recipient counterpart is based in the EU:
  • Payment currency must be EUR. For example, in case of invoice payment scenarios, the invoice currency must be EUR.
  • The counterpart’s default bank account must be in a country in the SEPA zone. See Counterpart bank accounts to learn how to specify bank account details.
• If the recipient counterpart is based in the UK:
  • Payment currency must be GBP. For example, in case of invoice payment scenarios, the invoice currency must be GBP.
• Counterpart’s bank account must have the account holder name specified.

Scenario: Make a SEPA Credit payment

This guide assumes an entity, its counterpart, and the counterpart’s bank account have already been created in Monite.

1. Enable the SEPA Credit payment method for the entity

To check if SEPA Credit is already enabled for the entity, call GET /entities/{entity_id}/payment_methods. If sepa_credit is not present in the list of payment methods, call PUT /entities/{entity_id}/payment_methods to add it. For more information, see Enabling payment methods for an entity.

In the example below, we’re enabling the entity to both receive and send SEPA Credit payments.

1
curl -X PUT 'https://api.sandbox.monite.com/v1/entities/e4678...1f6/payment_methods' \
2
     -H 'X-Monite-Version: 2024-01-31' \
3
     -H 'Authorization: Bearer YOUR_PARTNER_TOKEN' \
4
     -H 'Content-Type: application/json' \
5
     -d '{
6
       "payment_methods_receive": [
7
         "sepa_credit"
8
       ],
9
       "payment_methods_send": [
10
         "sepa_credit"
11
       ]
12
     }'

2. Create a payment link

A payment link is a URL that leads to a secure payment page where the payer (in this example, an entity) can specify their payment details and initiate the payment.

To generate a payment link, call POST /payment_links. In the request body, specify the recipient of the payment (in this example, a counterpart), the payment_methods to be displayed on the payment page, and other details. The required request fields vary based on whether or not the invoice being paid is stored in Monite. For more information, see Create a payment link.

1
curl -X POST 'https://api.sandbox.monite.com/v1/payment_links' \
2
     -H 'X-Monite-Version: 2024-01-31' \
3
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
4
     -H 'Authorization: Bearer YOUR_PARTNER_TOKEN' \
5
     -H 'Content-Type: application/json' \
6
     -d '{
7
       "object": {
8
         "type": "payable",
9
         "id": "PAYABLE_INVOICE_ID"
10
       }
11
       "recipient": {
12
         "type": "counterpart",
13
         "id": "COUNTERPART_ID"
14
       },
15
       "payment_methods": [
16
         "sepa_credit",
17
       ],
18
       "return_url": "https://example.com/return-url"
19
     }'

A successful response returns the id that can be used to initialize the Payment Web Component and the payment_page_url that can alternatively be shared with an entity representative.

1
{
2
  "id": "8babb691-3862-4676-97f4-d61b12284f25",
3
  ...
4
  "payment_intent": {
5
    "id": "e8dac9f8-e68c-4c8e-bcd3-b44cbb4f49d7",
6
    "updated_at": "2024-06-06T13:18:02.212807+00:00",
7
    "application_fee_amount": null,
8
    "object": null,
9
    "provider": null,
10
    "selected_payment_method": null,
11
    "status": "created"
12
  },
13
  "payment_intent_id": "e8dac9f8-e68c-4c8e-bcd3-b44cbb4f49d7",
14
  "payment_methods": [
15
    "sepa_credit"
16
  ],
17
  "payment_page_url": "https://pay.sandbox.monite.com?data=eyJpZCI...",
18
  "payment_reference": "INV-00042",
19
  "recipient": {
20
    "id": "cd830c8d-df0f-4ebd-99b7-d290e3506004",
21
    "bank_accounts": [
22
      {
23
        "id": "dc1efc0a-aac1-43bd-878e-b17e4d4d3039",
24
        "account_holder_name": "Tobias Weingart",
25
        "bic": "DEUTDEFFXXX",
26
        "country": "DE",
27
        "currency": "EUR",
28
        "iban": "DE74500700100100000900",
29
        "is_default": true,
30
        ...
31
      }
32
    ],
33
    "name": "Acme GmbH",
34
    "type": "counterpart"
35
  },
36
  ...
37
  "status": "created"
38
}

A payment intent for tracking the payment is also automatically created and stored in the payment_intent field of the payment link. You can also access that payment intent directly by calling GET /payment_intents/{payment_intent_id}.

3. Display the payment UI

After a payment link has been generated, you can display the payment UI to the entity representative:

• If your application uses the Payment Web Component, initialize the component using the payment link’s id to display the payment UI.

• If you use Monite-hosted payment page, redirect the entity representative to the payment link’s URL (payment_page_url).

The resulting payment page displays information about the payable invoice and payment amount. The entity representative can select their bank and provide the necessary details to authorize a SEPA Credit transfer to the vendor.

4. Track the payment status

After the entity representative confirms the payment, the payment link status is changed to succeeded and the payment intent status is changed to processing. Monite triggers the following webhooks when the status of payment links and intents is changed:

• payment_link.status_updated
• payment_intent.status_updated

You can monitor the status of the payment intent to know when the payment has been settled or rejected. The ID of the payment intent is stored in the payment_intent_id field of the payment link and is also included in payment_intent.status_updated webhooks. For more information, see Track the payment intent.

Test SEPA Credit payments

See Testing payments for a list of test credentials that you can use with the sandbox version of the payment page to simulate user consent and test both successful and declined payments.