Mandates (SEPA)

Get SEPA Creditor ProfileDeprecated

Role Requirements

tenant-mandate-read or tenant-admin

Description

Returns the details of a SEPA Creditor Profile.

Securitybearer
Request
path Parameters
creditorProfileRef
required
string (CreditorProfileRefV2) [ 1 .. 50 ] characters ^[a-zA-Z0-9-_\.]+$

Returns a creditor profile.

Example: fb39d6eb3ac44d6597f0f7221da5e663
header Parameters
x-account-id
required
string <uuid> [ 1 .. 50 ] characters

The Account Id.

x-tenant-id
required
string <uuid> (TenantIdV2) [ 1 .. 50 ] characters

The Tenant Id.

x-correlation-id
string

Correlation Id for the request.

Responses
200

Returns a SEPA Creditor Profile.

401

Unauthorized

403

Forbidden

404
  • Not Found - Creditor Profile was not found.
get/v2/mandates/creditor-profiles/sepa/{creditorProfileRef}
Request samples 
Response samples 
application/json
{
  • "creditorProfileRef": "fb39d6eb3ac44d6597f0f7221da5e663",
  • "profileName": "A_PROFILE_NAME_0",
  • "network": "SEPA",
  • "identifier": "AN_IDENTIFIER_0",
  • "name": "A_NAME_0",
  • "address": {
    • "streetAddress": "street 1",
    • "postcode": "8000",
    • "city": "Zurich",
    • "country": "CH"
    },
  • "metadata": {
    • "property1": "string",
    • "property2": "string"
    }
}
Create SEPA Creditor ProfileDeprecated
Role Requirements


tenant-mandate-write or tenant-admin


Description


Create a SEPA Creditor Profile.


Securitybearer 
Request 
header Parameters
x-account-id
required
string <uuid>   [ 1 .. 50 ] characters 
The Account Id.


 
x-tenant-id
required
string <uuid>  (TenantIdV2)   [ 1 .. 50 ] characters 
The Tenant Id.


 
x-correlation-id
string
Correlation Id for the request.


 
Request Body schema: application/json
The full details of the new SEPA Creditor-Profile.


creditorProfileRef
required
string (CreditorProfileRefV2)   [ 1 .. 50 ] characters ^[a-zA-Z0-9-_\.]+$
Unique reference identifier for the creditor profile. 
It accepts alphanumeric characters (a to z or digits), as well as the symbols -, _ and ..


 
profileName
required
string (ProfileNameV2)   [ 1 .. 100 ] characters 
A user-friendly name for the creditor profile that can easily be recognized.


 
identifier
required
string  [ 1 .. 100 ] characters 
The identifier of the SEPA creditor profile.


 
name
required
string  [ 1 .. 100 ] characters 
The name of the SEPA creditor profile.


 
required
object (SepaCreditorProfileAddressRequestV2) 
The address of the SEPA creditor profile.


 
object or null (MetadataV2) 
A collection of key-value pairs defined by the client. 
This object is subject to the following limits:


    

  • Maximum of 15 keys.
    • 

  • Keys have a maximum length of 64 characters.
    • 

  • Values have a maximum length of 256 characters.
    • 



 
Responses 
201
Creditor profile created.


400
Bad Request - Validation error response, containing errors such as:


    

  • The attribute CreditorProfileRef is required.
    • 

  • The attribute ProfileName is required.
    • 

  • The attribute Identifier is required.
    • 

  • The attribute Name is required.
    • 



401
Unauthorized


403
Forbidden


post/v2/mandates/creditor-profiles/sepa
Request samples 
application/json
{
  • "creditorProfileRef": "fb39d6eb3ac44d6597f0f7221da5e663",
  • "profileName": "A_PROFILE_NAME_0",
  • "identifier": "string",
  • "name": "string",
  • "address": {
    • "streetAddress": "string",
    • "postcode": "string",
    • "city": "string",
    • "country": "string"
    },
  • "metadata": {
    • "property1": "string",
    • "property2": "string"
    }
}
Response samples 
application/json
CreditorProfileRef was not specified.


{
  • "title": "BAD_REQUEST",
  • "detail": "See validation errors.",
  • "timestamp": "2021-01-30T08:30:00Z",
  • "correlationId": "0HMB2TA322CA7:00000001",
  • "status": 400,
  • "traceId": "0HMB2TA322CA7:00000001",
  • "errors": [
    • {
      • "title": "REQUIRED_ATTRIBUTE",
      • "detail": "The attribute CreditorProfileRef is required",
      • "metadata": {
        • "PropertyName": "CreditorProfileRef",
        • "AttemptedValue": "null",
        • "ErrorMessage": "The attribute CreditorProfileRef is required"
        }
      }
    ]
}
Update and register SEPA Mandate draftDeprecated
Role Requirements


tenant-mandate-write or tenant-admin


Description


Update and register a draft SEPA mandate.


Securitybearer 
Request 
path Parameters
mandateId
required
string <uuid>  (MandateIdV2)   [ 1 .. 50 ] characters 
The system's unique identifier for the mandate.


 
 Example:  d8c0e545-7d18-46b5-b807-aca31afc254f
header Parameters
x-account-id
required
string <uuid>   [ 1 .. 50 ] characters 
The Account Id.


 
x-tenant-id
required
string <uuid>  (TenantIdV2)   [ 1 .. 50 ] characters 
The Tenant Id.


 
x-correlation-id
string
Correlation Id for the request.


 
Request Body schema: application/json
The full details of the updated draft SEPA mandate.


customerRef
required
string  [ 1 .. 50 ] characters 
 
creditorProfileRef
required
string (CreditorProfileRefV2)   [ 1 .. 50 ] characters ^[a-zA-Z0-9-_\.]+$
Unique reference identifier for the creditor profile. 
It accepts alphanumeric characters (a to z or digits), as well as the symbols -, _ and ..


 
required
object (SepaDebtorDetailsRequestV2) 
 
object or null (MetadataV2) 
A collection of key-value pairs defined by the client. 
This object is subject to the following limits:


    

  • Maximum of 15 keys.
    • 

  • Keys have a maximum length of 64 characters.
    • 

  • Values have a maximum length of 256 characters.
    • 



 
Responses 
201
Mandate draft updated.


Registering mandate.


400
Bad Request - Validation error response, containing errors such as:


    

  • Mandate is not in state Draft, and cannot be edited or registered.
    • 

  • The attribute CustomerRef is required.
    • 

  • The attribute CreditorProfileRef is required.
    • 

  • The attribute Debtor.FirstName is required.
    • 

  • The attribute Debtor.LastName is required.
    • 

  • The attribute Debtor.Address.StreetAddress is required.
    • 

  • The attribute Debtor.Address.Postcode is required.
    • 

  • The attribute Debtor.Address.Postcode is invalid. Maximum length is 8.
    • 

  • The attribute Debtor.Address.City is required.
    • 

  • The attribute Debtor.Address.City is invalid. Maximum length is 100.
    • 

  • The attribute Debtor.Address.Country Country is invalid. Minimum length of 2 and a Maximum length of 2.
    • 

  • The attribute Debtor.Iban is invalid. Invalid Length or Country Code.
    • 

  • The attribute Debtor.Bic is required. Bic is required when country is one of the following CH,MC,YT,PM.
    • 

  • The attribute Debtor.Bic invalid. Invalid Length, Bank Code or Country Code.
    • 

  • The AccountHolderName field is required.
    • 

  • The field AccountHolderName must be a string with a minimum length of 3 and a maximum length of 18.
    • 

  • Invalid AccountHolderName, it must only include [A-Z 0-9 - . & /] and whitespace.
    • 



401
Unauthorized


403
Forbidden


404
    

  • Not Found - Mandate '00000000-0000-0000-0000-000000000000' was not found.
    • 



put/v2/mandates/sepa/{mandateId}/register
Request samples 
application/json
{
  • "customerRef": "string",
  • "creditorProfileRef": "fb39d6eb3ac44d6597f0f7221da5e663",
  • "debtor": {
    • "firstName": "John",
    • "lastName": "Smith",
    • "email": "JohnDangerSmith@imbursepayments.com",
    • "address": {
      • "houseNumberOrName": "221b",
      • "streetAddress": "Baker Street",
      • "extendedAddress": "string",
      • "postcode": "NW1 6XE",
      • "city": "London",
      • "country": "GB"
      },
    • "iban": "GB29 NWBK 6016 1331 9268 19",
    • "bic": "BKENGB2L123",
    • "accountHolderName": "MR J D SMITH"
    },
  • "metadata": {
    • "property1": "string",
    • "property2": "string"
    }
}
Response samples 
application/json
{
  • "financialInstrumentId": "35596f91-fea9-4297-b70b-01fdad24e25a",
  • "mandateId": "d8c0e545-7d18-46b5-b807-aca31afc254f",
  • "verificationCheck": {
    • "status": "VERIFIED",
    • "reason": "Verification Successful"
    }
}
Create and register SEPA MandateDeprecated
Role Requirements


tenant-mandate-write or tenant-admin


Description


Create and register a new Sepa mandate in a single step.


Securitybearer 
Request 
header Parameters
x-account-id
required
string <uuid>   [ 1 .. 50 ] characters 
The Account Id.


 
x-tenant-id
required
string <uuid>  (TenantIdV2)   [ 1 .. 50 ] characters 
The Tenant Id.


 
x-correlation-id
string
Correlation Id for the request.


 
Request Body schema: application/json
The full details of the new Sepa mandate.


customerRef
required
string  [ 1 .. 50 ] characters 
 
creditorProfileRef
required
string (CreditorProfileRefV2)   [ 1 .. 50 ] characters ^[a-zA-Z0-9-_\.]+$
Unique reference identifier for the creditor profile. 
It accepts alphanumeric characters (a to z or digits), as well as the symbols -, _ and ..


 
required
object (SepaDebtorDetailsRequestV2) 
 
object or null (MetadataV2) 
A collection of key-value pairs defined by the client. 
This object is subject to the following limits:


    

  • Maximum of 15 keys.
    • 

  • Keys have a maximum length of 64 characters.
    • 

  • Values have a maximum length of 256 characters.
    • 



 
Responses 
202
Mandate created.


400
Bad Request - Validation error response, containing errors such as:


    

  • The attribute CustomerRef is required.
    • 

  • The attribute CreditorProfileRef is required.
    • 

  • The attribute Debtor.FirstName is required.
    • 

  • The attribute Debtor.LastName is required.
    • 

  • The attribute Debtor.Address.StreetAddress is required.
    • 

  • The attribute Debtor.Address.Postcode is required.
    • 

  • The attribute Debtor.Address.Postcode is invalid. Maximum length is 8.
    • 

  • The attribute Debtor.Address.City is required.
    • 

  • The attribute Debtor.Address.City is invalid. Maximum length is 100.
    • 

  • The attribute Debtor.Address.Country Country is invalid. Minimum length of 2 and a Maximum length of 2.
    • 

  • The attribute Debtor.Iban is invalid. Invalid Length or Country Code.
    • 

  • The attribute Debtor.Bic is required. Bic is required when country is one of the following CH,MC,YT,PM.
    • 

  • The attribute Debtor.Bic invalid. Invalid Length, Bank Code or Country Code.
    • 

  • The AccountHolderName field is required.
    • 

  • The field AccountHolderName must be a string with a minimum length of 3 and a maximum length of 18.
    • 

  • Invalid AccountHolderName, it must only include [A-Z 0-9 - . & /] and whitespace.
    • 



401
Unauthorized


403
Forbidden


post/v2/mandates/sepa/register
Request samples 
application/json
{
  • "customerRef": "string",
  • "creditorProfileRef": "fb39d6eb3ac44d6597f0f7221da5e663",
  • "debtor": {
    • "firstName": "John",
    • "lastName": "Smith",
    • "email": "JohnDangerSmith@imbursepayments.com",
    • "address": {
      • "houseNumberOrName": "221b",
      • "streetAddress": "Baker Street",
      • "extendedAddress": "string",
      • "postcode": "NW1 6XE",
      • "city": "London",
      • "country": "GB"
      },
    • "iban": "GB29 NWBK 6016 1331 9268 19",
    • "bic": "BKENGB2L123",
    • "accountHolderName": "MR J D SMITH"
    },
  • "metadata": {
    • "property1": "string",
    • "property2": "string"
    }
}
Response samples 
application/json
{
  • "financialInstrumentId": "35596f91-fea9-4297-b70b-01fdad24e25a",
  • "mandateId": "d8c0e545-7d18-46b5-b807-aca31afc254f",
  • "verificationCheck": {
    • "status": "VERIFIED",
    • "reason": "Verification Successful"
    }
}
Get SEPA MandateDeprecated
Role Requirements


tenant-mandate-read or tenant-admin


Description


Get SEPA mandate.


Securitybearer 
Request 
path Parameters
mandateId
required
string <uuid>  (MandateIdV2)   [ 1 .. 50 ] characters 
The system's unique identifier for the mandate.


 
 Example:  d8c0e545-7d18-46b5-b807-aca31afc254f
header Parameters
x-account-id
required
string <uuid>   [ 1 .. 50 ] characters 
The Account Id.


 
x-tenant-id
required
string <uuid>  (TenantIdV2)   [ 1 .. 50 ] characters 
The Tenant Id.


 
x-correlation-id
string
Correlation Id for the request.


 
Responses 
200
Returns a SEPA mandate.


401
Unauthorized


403
Forbidden


404
    

  • Not Found - Mandate '00000000-0000-0000-0000-000000000000' was not found.
    • 



get/v2/mandates/sepa/{mandateId}
Request samples 
Response samples 
application/json
{
  • "mandateId": "d8c0e545-7d18-46b5-b807-aca31afc254f",
  • "mandateRef": "AYJ3BR4H67",
  • "network": "SEPA",
  • "mandateType": "BacsB2C",
  • "agreementType": "SingleUse",
  • "customerRef": "your.customer73625",
  • "status": "Draft",
  • "inactiveReason": {
    • "reasonCode": "DebtorCancelled",
    • "description": "The mandate was cancelled at a bank branch."
    },
  • "creditorProfileRef": "fb39d6eb3ac44d6597f0f7221da5e663",
  • "financialInstrumentId": "35596f91-fea9-4297-b70b-01fdad24e25a",
  • "created": "2019-08-24T14:15:22Z",
  • "debtor": {
    • "firstName": "John",
    • "lastName": "Smith",
    • "companyName": "Imburse Ltd",
    • "email": "JohnDangerSmith@imbursepayments.com",
    • "language": "en",
    • "address": {
      • "houseNumberOrName": "221b",
      • "streetAddress": "Baker Street",
      • "extendedAddress": "string",
      • "postcode": "NW1 6XE",
      • "city": "London",
      • "country": "GB"
      },
    • "iban": "GB29 NWBK 6016 1331 9268 19",
    • "bic": "BKENGB2L123",
    • "accountHolderName": "MR J D SMITH"
    },
  • "documentType": "Paper",
  • "metadata": {
    • "property1": "string",
    • "property2": "string"
    }
}
Amend SEPA MandateDeprecated
Role Requirements


tenant-mandate-write or tenant-admin


Description


Amend a SEPA mandate.


Securitybearer 
Request 
path Parameters
mandateId
required
string <uuid>  (MandateIdV2)   [ 1 .. 50 ] characters 
The system's unique identifier for the mandate.


 
 Example:  d8c0e545-7d18-46b5-b807-aca31afc254f
header Parameters
x-account-id
required
string <uuid>   [ 1 .. 50 ] characters 
The Account Id.


 
x-tenant-id
required
string <uuid>  (TenantIdV2)   [ 1 .. 50 ] characters 
The Tenant Id.


 
x-correlation-id
string
Correlation Id for the request.


 
Request Body schema: application/json
The amended Bacs mandate details.


required
object (SepaDebtorDetailsRequestV2) 
 
Responses 
201
Amending mandate.


400
Bad Request - Validation error response, containing errors such as:


    

  • Mandate is not in state Active, and cannot be amended.
    • 

  • The attribute Debtor.LastName is required.
    • 

  • The attribute Debtor.Address.StreetAddress is required.
    • 

  • The attribute Debtor.Address.Postcode is required.
    • 

  • The attribute Debtor.Address.Postcode is invalid. Maximum length is 8.
    • 

  • The attribute Debtor.Address.City is required.
    • 

  • The attribute Debtor.Address.City is invalid. Maximum length is 100.
    • 

  • The attribute Debtor.Address.Country Country is invalid. Minimum length of 2 and a Maximum length of 2.
    • 

  • The attribute Debtor.Iban is invalid. Invalid Length or Country Code.
    • 

  • The attribute Debtor.Bic is required. Bic is required when country is one of the following CH,MC,YT,PM.
    • 

  • The attribute Debtor.Bic invalid. Invalid Length, Bank Code or Country Code.
    • 

  • The AccountHolderName field is required.
    • 

  • The field AccountHolderName must be a string with a minimum length of 3 and a maximum length of 18.
    • 

  • Invalid AccountHolderName, it must only include [A-Z 0-9 - . & /] and whitespace.
    • 



401
Unauthorized


403
Forbidden


post/v2/mandates/sepa/{mandateId}/amend
Request samples 
application/json
{
  • "debtor": {
    • "firstName": "John",
    • "lastName": "Smith",
    • "email": "JohnDangerSmith@imbursepayments.com",
    • "address": {
      • "houseNumberOrName": "221b",
      • "streetAddress": "Baker Street",
      • "extendedAddress": "string",
      • "postcode": "NW1 6XE",
      • "city": "London",
      • "country": "GB"
      },
    • "iban": "GB29 NWBK 6016 1331 9268 19",
    • "bic": "BKENGB2L123",
    • "accountHolderName": "MR J D SMITH"
    }
}
Response samples 
application/json
{
  • "financialInstrumentId": "35596f91-fea9-4297-b70b-01fdad24e25a",
  • "mandateId": "d8c0e545-7d18-46b5-b807-aca31afc254f",
  • "verificationCheck": {
    • "status": "VERIFIED",
    • "reason": "Verification Successful"
    }
}
Copyright 2024 Duck Creek Technologies. All Rights Reserved.