Mandate transfer

KYC

After having obtained the user consent, you can add this information during the transfer process. You are able, if desired, to have a silent mandate transfer with a simplified KYC process (light KYC). Meaning: no mandatory manual interaction with Digiteal required. However this will cap the maximum withdrawal limit to 200€/month. We grant you this ability after careful review of your activities and the risks associated with them.

Mandatory information for the simplified KYC includes:

A signed mandate document
Persons
- first name + last name
- physical address
- email address
Companies
- first name + last name
- physical address
- email address
- company name
- company identification number

Also note that the maximum withdraw amount should also match (read: equal or less) the limit assigned to your company by Digiteal.

SDD transfer

Transfer a SDD mandate for a person

Transfer person

Here you can find an example of the request body in JSON we would use for the light KYC flow:

{
  "complete": false,
  "configuration": {
    "currency": "EUR",
    "executionType": "DUE_DATE",
    "periodicity": "MONTH",
    "thresholdInCents": 20000
  },
  "contractApproval": {
    "approvalDate": "2022-05-02",
    "ipAddress": "string",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.84 Safari/537.36 OPR/85.0.4341.72"
  },
  "creditorVatNumber": "BE0000000001",
  "customerInternalId": "MyCustomer1",
  "debtor": {
    "address": {
      "city": "Gembloux",
      "country": "Belgium",
      "countryCode": "BE",
      "houseNumber": "C",
      "streetName": "Rue du moulin",
      "zipCode": "29650"
    },
    "birthDay": "1999-11-27",
    "birthPlace": "Gembloux",
    "email": "[email protected]",
    "firstName": "Salem",
    "gender": "MALE",
    "language": "FR",
    "lastName": "BEN",
    "ibans": [
      "BE26817697538429"
    ]
  },
  "debtorIBAN": "BE26817697538429",
  "notificationSettings": {
    "autoPayment": true,
    "autoPaymentThreshold": true,
    "invoice": false,
    "issuer": false,
    "mail": false,
    "paymentIssue": false,
    "push": false,
    "reminder": false
  }
}

Important to know:

customerInternalId is a unique identifier the integrator can choose refer to a client. This will be useful f.e. for the SDD payments later on.
According to the chosen KYC flow:
- Light KYC: set { complete: false } in the request body
- Complete KYC: set { complete: true} in the request body
The debtorIBAN field must also be present in the ibans array
For the configuration object: setting the executionType to DUE_DATE will give you the most flexibility regarding payment collection (see: the SDD Payment section)

Transfer a SDD mandate for a company

Transfer company

Here you can find an example of the request body in JSON we would use for the complete KYC flow:

{
  "complete": true,
  "contractApproval": {
    "approvalDate": "2019-11-30",
    "ipAddress": "ipsum",
    "userAgent": "Mozilla/5.0 (Linux; Android 7.0; SM-G892A Build/NRD90M; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/60.0.3112.107 Mobile Safari/537.36"
  },
  "configuration": {
    "currency": "EUR",
    "executionType": "DUE_DATE",
    "periodicity": "MONTH",
    "thresholdInCents": 20000
  },
  "creationDate": "YYYY-MM-DD",
  "custumerInternalId": "MyCustomer1",
  "creditorVatNumber": "BE0000000097",
  "debtor": {
    "address": {
      "city": "Bruxelles",
      "countryCode": "BE",
      "houseNumber": "tempor esse elit",
      "streetName": "Rue de la Loi",
      "zipCode": "veniam quis nisi eu",
      "country": "Belgique"
    },
    "companyName": "Your COmpany",
    "contact": {
      "address": {
        "city": "Bruxelles",
        "countryCode": "BE",
        "houseNumber": "dolore aliqua",
        "streetName": "Rue de la Loi",
        "zipCode": "et adipisicing Lorem id",
        "country": "Belgique"
      },
      "email": "[email protected]",
      "birthDay": "1990-12-31",
      "birthPlace": "Cook, NZ",
      "firstName": "John",
      "gender": "MALE",
      "idDocumentValidityEnd": "2030-12-31",
      "language": "EN",
      "lastName": "Doe",
      "nationalities": [
        "BE"
      ],
      "pep": true,
      "pepCustomerExplanation": "Prime minister of New Zeland",
      "sectors": [
        {
          "type": "STUDIES",
          "details": "Part-time"
        },
        {
          "type": "STUDIES",
          "details": "Part-time"
        }
      ]
    },
    "identificationNumber": "BE:VAT:BE0000010097",
    "creationDate": "2012-12-31",
    "ibans": [
      "BE74735471499507"
    ],
    "settlementGrouping": "PER_MONTH",
    "integratorIdentificationNumber": "BE:VAT:BE0000000001",
    "ubos": [
      {
        "birthDay": "1990-12-31",
        "birthPlace": "Cook, NZ",
        "firstName": "John",
        "gender": "MALE",
        "lastName": "Doe",
        "pep": true,
        "pepCustomerExplanation": "Prime minister of New Zeland"
      }
    ]
  },
  "notificationSettings": {
    "autoPayment": false,
    "autoPaymentThreshold": false,
    "invoice": false,
    "issuer": false,
    "mail": false,
    "paymentIssue": false,
    "push": false,
    "reminder": false
  },
  "product": "PAYMENT",
  "returnURL": "https://www.myportal.com/digitealRegistrationConfirmed",
  "welcomeMessage": "YourTelecom invites you to use Digiteal to pay all your invoices in one click."
}

Important to know:

customerInternalId is a unique identifier the integrator can choose refer to a client. This will be useful f.e. for the SDD payments later on.
the fields identificationNumber and integratorIdentificationNumber are identifiers that uniquely identify the company and that we generate according to a standard ruleset. You can consult the full details and list here.
According to the chosen KYC flow:
- Light KYC: set { complete: false } in the request body
- Complete KYC: set { complete: true} in the request body
The debtorIBAN field must also be present in the ibans array
For the configuration object, setting the executionType to DUE_DATE will give you the most flexibility regarding payment collection (see: the SDD Payment section)

Upload the signed mandate document

Upload KYC document

Here’s an example of the JSON request body:

Content-Type: "multipart/form-data"

{
    "email": "[email protected]",
    "name": "Example Corp.",
    "requesterVAT": "BE0000001",
    "type": "BANK_MANDATE",
    "file": _FORMDATA_
}