Direct debit mandate object

A direct debit mandate authorises a creditor (a company, public administration, or association) to collect payments from a debtor's bank account (a company, public administration, association, or individual).

AttributeDescription
id
string
The direct debit mandate ID.
object
string
Always direct_debit_mandate.
connected_account_id
string
The the direct debit mandate connected account.
direction
string
The direct debit mandate direction. Either outgoing or incoming.
reference
string
The the direct debit mandate reference.
signature_date
date
The direct debit mandate signature date.
type
string
The direct debit mandate type. Supported direct debit mandate types include:
  • sepa_core
  • sepa_b2b
  • bacs_debit
sequence
string
The sequence of the direct debit mandate. Either one_off or recurring.
receiving_account
object
The account to debit.

It must be empty if receiving_account_id is filled.

The receiving account includes the following attributes:
  • account_number: the account number of the receiving account. See accepted account number formats here .
  • bank_code: the BIC / Swift code or sort code, depending on the country and bank. Only upper case letters allowed
  • holder_name: the name of the company or individual holding the account
  • holder_address: the address of the account holder address, as an address object
receiving_account_id
string
The ID of the external account to debit. It must be empty if receiving_account is filled.
originating_account
object
The account to credit.

This attribute is required for financial institution connected accounts. It cannot be specified if originating_account_id is filled or if the connected account's type is corporate.

The originating account includes the following attributes:
  • account_number: the account number of the receiving account. See accepted account number formats here .
  • bank_code: the BIC / Swift code or sort code, depending on the country and bank. Only upper case letters allowed
  • holder_name: the name of the company or individual holding the account
  • creditor_identifier: the creditor identifier
  • holder_address: the address of the account holder address, as an address object
originating_account_id
string
The ID of the internal account to be credited. It must be left empty if the originating_account attribute is filled or if connected account's type is corporate.
status
string
The direct debit mandate status.
metadata
object
Additional data in JSON key:value format. See Metadata.
created_at
datetime
The direct debit mandate creation UTC timestamp.

Below is an example of a direct debit mandate:

{
   "id": "c3fd9ee4-2aab-11ed-a261-0242ac120002",
   "object": "direct_debit_mandate",
   "connected_account_id": "591d818a-27c5-11ee-be56-0242ac120002",
   "direction": "outgoing",
   "reference": "042a5034",
   "signature_date": "2022-09-03",
   "type": "sepa_core",
   "sequence": "recurring",
   "receiving_account": {
      "account_number": "FR7601234567891127967100082",
      "bank_code": "BNPAFRPPXXX",
      "holder_name": "PartnerCo",
      "holder_address": {
         "line_1": "1, rue de la Bourse",
         "line_2": "",
         "postal_code": "59000",
         "region_state": "",
         "city": "Lille",
         "country": "FR"
      }
   },
   "receiving_account_id": "b38f5318-a389-4278-9cbe-d16116750982",
   "originating_account": {
      "account_number": "FR7601234567890627967100010",
      "bank_code": "SOGEFRPP",
      "holder_name": "SoftwareCo",
      "creditor_identifier": "",
      "holder_address": {
         "line_1": "1, rue de l'Abondance",
         "line_2": "",
         "postal_code": "69003",
         "region_state": "",
         "city": "Lyon",
         "country": "FR"
      }
   },
   "originating_account_id": "30b356df-4135-4641-ae9e-e3a7903b5308",
   "status": "active",
   "metadata": {},
   "created_at": "2022-09-03T08:12:11.734182Z"
}