API Reference
Start typing to search…

Create a SEPA mandate

post
https://app.pennylane.com/api/external/v2/sepa_mandates

This endpoint allows you to create a SEPA mandate to enable direct debit payments

This endpoint requires the following scope: customer_mandates:all

Query Params
boolean
Defaults to true

If you are already using the X-Use-2026-API-Changes header, you can ignore this parameter.

The Pennylane API is introducing important changes, which will be rolled out in three phases: preview, sunset and cleanup.

For new user, please use this parameter with true value to opt in directly to the new version of the API.

Preview phase: From January 14th to April 7th 2026. Opt in by setting this attribute to true to test and migrate to the new behavior.

Sunset phase: From April 8th to June 30th 2026. The new behavior becomes the default. Set this attribute to false if you need additional time to migrate.

Cleanup phase: Starting July 1st 2026 The old behavior will no longer be available. You must have migrated by this point.

For more details, see our API documentation https://pennylane.readme.io/docs/2026-api-changes-guide for migration instructions.

Body Params
string

Name of the customer's bank

string
required

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

string
required

International Bank Account Number (IBAN) of the customer

string
enum
Defaults to RCUR

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
Allowed:
date
required

Date when the mandate was signed

string
required

Unique identifier for the mandate

int64
required

ID of the customer for which the mandate is created

Responses

Updated 23 days ago

Language
Credentials
OAuth2
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 23 days ago