Sign in

v1

latestOpenAPI 3.0.12026-07-141671231.8 MB
Mandates

Update a SEPA mandate

This endpoint allows you to update an existing SEPA mandate

ℹ️ This endpoint requires the following scope: customer_mandates:all

put/api/external/v2/sepa_mandates/{id}

Path parameters

idinteger required

ID of the SEPA mandate to update

Request body

bankstring nullable

Name of the customer's bank

bicstring

Bank Identifier Code (BIC) of the customer's bank

ibanstring

International Bank Account Number (IBAN) of the customer

sequence_type'FRST' | 'OOFF' | 'RCUR' | 'FNAL'

SEPA mandate sequence type that defines the payment process.

  • FRST: First payment in a series of recurring payments
  • OOFF: One-off payment
  • RCUR: Recurring payment that is not the first payment
  • FNAL: Final payment in a series of recurring payments
signed_atstring date

Date when the mandate was signed

identifierstring

Unique identifier for the mandate

customer_idinteger

ID of the customer for which the mandate is created

Example request

{
  "bank": "BNP Paribas",
  "bic": "BNPAFRPP",
  "iban": "FR3612739000506556687647Z31",
  "sequence_type": "RCUR",
  "signed_at": "2025-04-24",
  "identifier": "K-02-2025-12345",
  "customer_id": 47334785
}

Response

Returns the updated SEPA mandate

idinteger required

ID of the created SEPA mandate

bankstring nullable required

Name of the customer's bank

bicstring required

Bank Identifier Code (BIC) of the customer's bank

ibanstring required

International Bank Account Number (IBAN) of the customer

sequence_type'FRST' | 'OOFF' | 'RCUR' | 'FNAL' required

SEPA mandate sequence type that defines the payment process.

  • FRST: First payment in a series of recurring payments
  • OOFF: One-off payment
  • RCUR: Recurring payment that is not the first payment
  • FNAL: Final payment in a series of recurring payments
signed_atstring date required

Date when the mandate was signed

identifierstring required

Unique identifier for the mandate

created_atstring date-time required

Creation date of the SEPA mandate

updated_atstring date-time required

Last update date of the SEPA mandate

Example response

{
  "id": 12345,
  "bank": "BNP Paribas",
  "bic": "BNPAFRPP",
  "iban": "FR3612739000506556687647Z31",
  "sequence_type": "RCUR",
  "signed_at": "2025-04-24",
  "identifier": "K-02-2023-12345",
  "customer": {
    "id": 42,
    "url": "https://app.pennylane.com/api/external/v2/customers/42"
  },
  "created_at": "2023-08-07T14:23:12.000Z",
  "updated_at": "2023-08-07T14:23:12.000Z"
}