Direct Debit API (V2)

Download OpenAPI specification:Download

DirectDebit

Provides methods to retrieve Direct Debit payments and instructions.

Cancel Instruction

CancelInstruction method is used to cancel the defined Direct Debit instruction that will stop consumer's onwards direct debit payment. Applicable fees for the direct debit will be charged and notify the consumer.

Request
header Parameters
Authorization
required
string

A JWT access token returned from the security/login method, uniquely identifying your partner login session. This is required to make requests to the API.

Request Body schema: application/json

The request information.

DirectDebitInstructionID
required
integer <int32>

Unique identifier of a Direct Debit instruction.

DirectDebitInstructionReasonCode
required
string [ 0 .. 1 ] characters

The look up value that identifies the reason for cancellation of the Direct Debit.

        0 = Instruction cancelled - Refer to Payer

        1 = Instruction cancelled

        2 = Payer deceased

        3 = Account transferred

        4 = Account closed

        5 = Account transferred to a different branch of bank/building society

        6 = Advance notice disputed

        7 = Instruction amended
AccountIdentifier
integer <int32>

Unique identifier of an Account.

Note: Either Account Identifier or combination of Account Number and SortCode or combination of IBAN and BIC must be provided for API request. For international account (outside UK) provide the combination of IBAN and BIC only. For account within UK, provide either of the three combinations.

AccountNumber
string [ 0 .. 8 ] characters

Eight-digit account number.

SortCode
string [ 0 .. 6 ] characters

Sort code identifies both the bank and the branch where the conusmer account is held.

IBAN
string [ 0 .. 34 ] characters

International Bank Account Number (IBAN) is a unique code that identifies banks globally. The bank assigns an IBAN to each of its accounts. IBAN is used to make across the country payments process easier and faster.

BIC
string [ 0 .. 11 ] characters

Bank Identifier Code (BIC) identifies the beneficiary's bank quickly and easily. BIC contains the name, country, location and branch of the bank.

ClientRequestReference
string [ 0 .. 50 ] characters

Solaris partners should provide a reference number in each API request for tracking/auditing purpose of actions performed on the Solaris platform.

CultureID
integer <int32>

Unique identifier of the response language. Default language value is 1. i.e. UK English. Other supported values are 1 = UK English, 2 = Russian, 3 = Latvian.

Responses
200

OK

400

Bad Request

500

Internal Server Error

post/DirectDebit/CancelInstruction
Request samples
application/json
{
  • "DirectDebitInstructionID": 19,
  • "DirectDebitInstructionReasonCode": "1",
  • "AccountIdentifier": 949838,
  • "AccountNumber": "00000570",
  • "SortCode": "608370",
  • "IBAN": "GB35CNFV60837000000570",
  • "BIC": "CNFVGB21XXX",
  • "ClientRequestReference": "[ReferenceExample]",
  • "CultureID": 1
}
Response samples
application/json
{
  • "Description": "Success",
  • "ResponseCode": "000",
  • "ResponseDateTime": "2021-12-21T13:58:02.899",
  • "ClientRequestReference": "reference",
  • "RequestID": 27194
}

Get Instructions For Envelope

GetInstructionForEnvelope method is used to get the instruction of Direct Debit that is binded with an envelope for an account detail provided in API request. It returns Instruction identifier for Direct Debit, Service User Name and Service User Number etc details.

Request
header Parameters
Authorization
required
string

A JWT access token returned from the security/login method, uniquely identifying your partner login session. This is required to make requests to the API.

Request Body schema: application/json

The request information.

AccountIdentifier
integer <int32>

Unique identifier of an Account.

Note: Either Account Identifier or combination of Account Number and SortCode or combination of IBAN and BIC must be provided for API request. For international account (outside UK) provide the combination of IBAN and BIC only. For account within UK, provide either of the three combinations.

AccountNumber
string [ 0 .. 8 ] characters

Eight-digit account number.

SortCode
string [ 0 .. 6 ] characters

Sort code identifies both the bank and the branch where the conusmer account is held.

IBAN
string [ 0 .. 34 ] characters

International Bank Account Number (IBAN) is a unique code that identifies banks globally. The bank assigns an IBAN to each of its accounts. IBAN is used to make across the country payments process easier and faster.

BIC
string [ 0 .. 11 ] characters

Bank Identifier Code (BIC) identifies the beneficiary's bank quickly and easily. BIC contains the name, country, location and branch of the bank.

ClientRequestReference
string [ 0 .. 50 ] characters

Solaris partners should provide a reference number in each API request for tracking/auditing purpose of actions performed on the Solaris platform.

CultureID
integer <int32>

Unique identifier of the response language. Default language value is 1. i.e. UK English. Other supported values are 1 = UK English, 2 = Russian, 3 = Latvian.

Responses
200

OK

400

Bad Request

500

Internal Server Error

post/DirectDebit/GetInstructionsForEnvelope
Request samples
application/json
{
  • "AccountIdentifier": 949838,
  • "AccountNumber": "00000570",
  • "SortCode": "608370",
  • "IBAN": "GB35CNFV60837000000570",
  • "BIC": "CNFVGB21XXX",
  • "ClientRequestReference": "[ReferenceExample]",
  • "CultureID": 1
}
Response samples
application/json
{
  • "EnvelopeInstructionResList": [
    ],
  • "Description": "Success",
  • "ResponseCode": "000",
  • "ResponseDateTime": "2021-12-21T13:58:02.899",
  • "ClientRequestReference": "reference",
  • "RequestID": 27194
}

Get Specific DD Payment

Direct Debit Payment is executed against the instruction created for an account. GetSpecificDDPayment method is used to get the details of specific direct debit payment for an account detail and Direct Debit Payment Reference Identifier provided in API request.

        It returns the details like Instruction Identifier against which payment has been executed, Status code for an instruction, Service User details, Payment Amount etc. for Direct Debit payments.
Request
header Parameters
Authorization
required
string

A JWT access token returned from the security/login method, uniquely identifying your partner login session. This is required to make requests to the API.

Request Body schema: application/json

The request information.

DirectDebitPaymentReferenceID
required
integer <int32>

Unique reference identifier of the Direct Debit payment.

AccountIdentifier
integer <int32>

Unique identifier of an Account.

Note: Either Account Identifier or combination of Account Number and SortCode or combination of IBAN and BIC must be provided for API request. For international account (outside UK) provide the combination of IBAN and BIC only. For account within UK, provide either of the three combinations.

AccountNumber
string [ 0 .. 8 ] characters

Eight-digit account number.

SortCode
string [ 0 .. 6 ] characters

Sort code identifies both the bank and the branch where the conusmer account is held.

IBAN
string [ 0 .. 34 ] characters

International Bank Account Number (IBAN) is a unique code that identifies banks globally. The bank assigns an IBAN to each of its accounts. IBAN is used to make across the country payments process easier and faster.

BIC
string [ 0 .. 11 ] characters

Bank Identifier Code (BIC) identifies the beneficiary's bank quickly and easily. BIC contains the name, country, location and branch of the bank.

ClientRequestReference
string [ 0 .. 50 ] characters

Solaris partners should provide a reference number in each API request for tracking/auditing purpose of actions performed on the Solaris platform.

CultureID
integer <int32>

Unique identifier of the response language. Default language value is 1. i.e. UK English. Other supported values are 1 = UK English, 2 = Russian, 3 = Latvian.

Responses
200

OK

400

Bad Request

500

Internal Server Error

post/DirectDebit/GetSpecificDDPayment
Request samples
application/json
{
  • "DirectDebitPaymentReferenceID": 0,
  • "AccountIdentifier": 949838,
  • "AccountNumber": "00000570",
  • "SortCode": "608370",
  • "IBAN": "GB35CNFV60837000000570",
  • "BIC": "CNFVGB21XXX",
  • "ClientRequestReference": "[ReferenceExample]",
  • "CultureID": 1
}
Response samples
application/json
{
  • "DDPaymentRes": {
    },
  • "Description": "Success",
  • "ResponseCode": "000",
  • "ResponseDateTime": "2021-12-21T13:58:02.899",
  • "ClientRequestReference": "reference",
  • "RequestID": 27194
}

Get Specific Instruction

GetSpecificInstruction method is used to get the details of specific Direct Debit instruction for an account detail and Direct Debit Instruction Identifier provided in API request.

        It returns the details like Instruction Status, Service user details, Payment date, Payment amount etc. for Direct Debit instruction.
Request
header Parameters
Authorization
required
string

A JWT access token returned from the security/login method, uniquely identifying your partner login session. This is required to make requests to the API.

Request Body schema: application/json

The request information.

DirectDebitInstructionID
required
integer <int32>

Unique identifier of the Direct Debit instruction.

AccountIdentifier
integer <int32>

Unique identifier of an Account.

Note: Either Account Identifier or combination of Account Number and SortCode or combination of IBAN and BIC must be provided for API request. For international account (outside UK) provide the combination of IBAN and BIC only. For account within UK, provide either of the three combinations.

AccountNumber
string [ 0 .. 8 ] characters

Eight-digit account number.

SortCode
string [ 0 .. 6 ] characters

Sort code identifies both the bank and the branch where the conusmer account is held.

IBAN
string [ 0 .. 34 ] characters

International Bank Account Number (IBAN) is a unique code that identifies banks globally. The bank assigns an IBAN to each of its accounts. IBAN is used to make across the country payments process easier and faster.

BIC
string [ 0 .. 11 ] characters

Bank Identifier Code (BIC) identifies the beneficiary's bank quickly and easily. BIC contains the name, country, location and branch of the bank.

ClientRequestReference
string [ 0 .. 50 ] characters

Solaris partners should provide a reference number in each API request for tracking/auditing purpose of actions performed on the Solaris platform.

CultureID
integer <int32>

Unique identifier of the response language. Default language value is 1. i.e. UK English. Other supported values are 1 = UK English, 2 = Russian, 3 = Latvian.

Responses
200

OK

400

Bad Request

500

Internal Server Error

post/DirectDebit/GetSpecificInstruction
Request samples
application/json
{
  • "DirectDebitInstructionID": 19,
  • "AccountIdentifier": 949838,
  • "AccountNumber": "00000570",
  • "SortCode": "608370",
  • "IBAN": "GB35CNFV60837000000570",
  • "BIC": "CNFVGB21XXX",
  • "ClientRequestReference": "[ReferenceExample]",
  • "CultureID": 1
}
Response samples
application/json
{
  • "DDInstructionRes": {
    },
  • "Description": "Success",
  • "ResponseCode": "000",
  • "ResponseDateTime": "2021-12-21T13:58:02.899",
  • "ClientRequestReference": "reference",
  • "RequestID": 27194
}

List DD Payments

ListDDPayments method is used to get the list of all Payment details for a particular account and direct debit instruction identifier provided in API request.

        It returns the details like Instruction Identifier against which payment has been executed, Status code for an instruction, Service User details, Payment Amount etc. for Direct Debit payments.
Request
header Parameters
Authorization
required
string

A JWT access token returned from the security/login method, uniquely identifying your partner login session. This is required to make requests to the API.

Request Body schema: application/json

The request information.

DirectDebitInstructionID
required
integer <int32>

Unique identifier of the Direct Debit instruction.

AccountIdentifier
integer <int32>

Unique identifier of an Account.

Note: Either Account Identifier or combination of Account Number and SortCode or combination of IBAN and BIC must be provided for API request. For international account (outside UK) provide the combination of IBAN and BIC only. For account within UK, provide either of the three combinations.

AccountNumber
string [ 0 .. 8 ] characters

Eight-digit account number.

SortCode
string [ 0 .. 6 ] characters

Sort code identifies both the bank and the branch where the conusmer account is held.

IBAN
string [ 0 .. 34 ] characters

International Bank Account Number (IBAN) is a unique code that identifies banks globally. The bank assigns an IBAN to each of its accounts. IBAN is used to make across the country payments process easier and faster.

BIC
string [ 0 .. 11 ] characters

Bank Identifier Code (BIC) identifies the beneficiary's bank quickly and easily. BIC contains the name, country, location and branch of the bank.

ClientRequestReference
string [ 0 .. 50 ] characters

Solaris partners should provide a reference number in each API request for tracking/auditing purpose of actions performed on the Solaris platform.

CultureID
integer <int32>

Unique identifier of the response language. Default language value is 1. i.e. UK English. Other supported values are 1 = UK English, 2 = Russian, 3 = Latvian.

Responses
200

OK

400

Bad Request

500

Internal Server Error

post/DirectDebit/ListDDPayments
Request samples
application/json
{
  • "DirectDebitInstructionID": 0,
  • "AccountIdentifier": 949838,
  • "AccountNumber": "00000570",
  • "SortCode": "608370",
  • "IBAN": "GB35CNFV60837000000570",
  • "BIC": "CNFVGB21XXX",
  • "ClientRequestReference": "[ReferenceExample]",
  • "CultureID": 1
}
Response samples
application/json
{
  • "DDPaymentResList": [
    ],
  • "Description": "Success",
  • "ResponseCode": "000",
  • "ResponseDateTime": "2021-12-21T13:58:02.899",
  • "ClientRequestReference": "reference",
  • "RequestID": 27194
}

List Instructions

ListInstructions method is used to get list of all Direct Debit instruction for a particular account provided in API request.

        It returns the details like Instruction Status, Service user details, Payment date, Payment amount etc. for Direct Debit instruction.
Request
header Parameters
Authorization
required
string

A JWT access token returned from the security/login method, uniquely identifying your partner login session. This is required to make requests to the API.

Request Body schema: application/json

The request information.

AccountIdentifier
integer <int32>

Unique identifier of an Account.

Note: Either Account Identifier or combination of Account Number and SortCode or combination of IBAN and BIC must be provided for API request. For international account (outside UK) provide the combination of IBAN and BIC only. For account within UK, provide either of the three combinations.

AccountNumber
string [ 0 .. 8 ] characters

Eight-digit account number.

SortCode
string [ 0 .. 6 ] characters

Sort code identifies both the bank and the branch where the conusmer account is held.

IBAN
string [ 0 .. 34 ] characters

International Bank Account Number (IBAN) is a unique code that identifies banks globally. The bank assigns an IBAN to each of its accounts. IBAN is used to make across the country payments process easier and faster.

BIC
string [ 0 .. 11 ] characters

Bank Identifier Code (BIC) identifies the beneficiary's bank quickly and easily. BIC contains the name, country, location and branch of the bank.

ClientRequestReference
string [ 0 .. 50 ] characters

Solaris partners should provide a reference number in each API request for tracking/auditing purpose of actions performed on the Solaris platform.

CultureID
integer <int32>

Unique identifier of the response language. Default language value is 1. i.e. UK English. Other supported values are 1 = UK English, 2 = Russian, 3 = Latvian.

Responses
200

OK

400

Bad Request

500

Internal Server Error

post/DirectDebit/ListInstructions
Request samples
application/json
{
  • "AccountIdentifier": 949838,
  • "AccountNumber": "00000570",
  • "SortCode": "608370",
  • "IBAN": "GB35CNFV60837000000570",
  • "BIC": "CNFVGB21XXX",
  • "ClientRequestReference": "[ReferenceExample]",
  • "CultureID": 1
}
Response samples
application/json
{
  • "DDInstructionResList": [
    ],
  • "Description": "Success",
  • "ResponseCode": "000",
  • "ResponseDateTime": "2021-12-21T13:58:02.899",
  • "ClientRequestReference": "reference",
  • "RequestID": 27194
}
Solaris is the brand name for the regulated entities Contis Financial Services Ltd and UAB „Finansinės paslaugos „Contis“, which are part of the Solaris Group.