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).

Attribute	Description
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 IBAN or account number. If an IBAN, Numeral verifies the validity of the IBAN, but does not verify that the IBAN exists or belongs to the account holder `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 counterparty account to debit. It must be empty if `receiving_account` is filled.
originating_account object	The account to credit. It must be filled for financial institution customers and must be empty for corporate customers. The originating account includes the following attributes: `account_number`: the IBAN or account number. If an IBAN, Numeral verifies the validity of the IBAN, but does not verify that the IBAN exists or belongs to the account holder `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
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"
      }
   },
   "status": "active",
   "metadata": {},
   "created_at": "2022-09-03T08:12:11.734182Z"
}