SIIN for SDD
- Technical Writer
1. Introduction
SEPA Instant Instant Notification (SIIN) is basically additional information/notification(s) of SEPA inbound transactions.
2. Notifications
The following figure depicts the timeline of SIIN notifications for SDD:
Notes
After a mandate has been triggered, it either gets executed or executed rejected.
A mandate can get executed rejected during settlement.
Mandate cancellation may take place at any given point throughout the process.
Type | Description | Notification |
|---|---|---|
Mandate created | Mandate has been created. | {
"id": "BLBRE-202410-00000257",
"uid": "5efc2c74-4fd0-4895-af0b-3ad053f50d20",
"recurring_transaction": false,
"event": "mandate_created",
"original_sender_iban": "CY80904000010001918197001000",
"original_sender_name": "John Smith",
"original_sender_bank_country": "Cyprus",
"screen_entities": [],
"payment_provider_responses": [
{
"operation_successful": true,
"provider_name": "MT59ZZZ9kj9553335T",
"reference_code": "BLBRE-202410-00000257",
"provider_reference_code": "CY17002001280000001200527600",
"response_id": "Frequent",
"status_code": "2024-10-30T09:38:56.4857597Z",
"external_correlation_id": "",
"details": "Mandate01",
"manual_reconciliation": false
}
],
"payment_amount": {
"currency": "EUR",
"amount": 5000
},
"beneficiary_iban": "CY21002001950000357001234567",
"original_sender_address": "",
"transaction_detail": ""
} |
Mandate rejected | Mandate has been rejected. | {
"id": "BLBRE-202410-00000257",
"uid": "5efc2c74-4fd0-4895-af0b-3ad053f50d21",
"recurring_transaction": false,
"event": "mandate_rejected",
"original_sender_iban": "",
"original_sender_name": "",
"original_sender_bank_country": "",
"beneficiary_iban": "",
"original_sender_address": "",
"transaction_detail": ""
"screen_entities": [],
"payment_provider_responses": [
{
"operation_successful": true,
"provider_name": "MT59ZZZ9kj9553335T",
"reference_code": "BLBRE-202410-00000257",
"provider_reference_code": "CY17002001280000001200527600",
"response_id": "",
"status_code": "2024-10-30T09:38:56.4857597Z",
"external_correlation_id": "",
"details": "Mandate01",
"manual_reconciliation": false
}
],
"payment_amount": {
"currency": "",
"amount": null
}
} |
Mandate triggered | Mandate has been triggered. | {
"id": "BLBRE-202410-00000257",
"uid": "5efc2c74-4fd0-4895-af0b-3ad053f50d22",
"recurring_transaction": false,
"event": "mandate_triggered",
"original_sender_iban": "CY80904000010001918197001000",
"original_sender_name": "John Smith",
"original_sender_bank_country": "Cyprus",
"screen_entities": [],
"payment_provider_responses": [
{
"operation_successful": true,
"provider_name": "Merchant name",
"reference_code": "BLBRE-202410-00000257",
"provider_reference_code": "CY17002001280000001200527600",
"response_id": "Frequent",
"status_code": "2024-10-30T09:38:56.4857597Z",
"external_correlation_id": "",
"details": "Mandate01-1",
"manual_reconciliation": false
}
],
"payment_amount": {
"currency": "EUR",
"amount": 5000
},
"beneficiary_iban": "CY21002001950000357001234567",
"original_sender_address": "",
"transaction_detail": "Mandate01-1"
} |
Mandate executed | Mandate has been executed. | |
Mandate executed rejected | Mandate execution has been rejected. | |
Mandate settled | Mandate has been settled. | |
Mandate cancelled | Mandate has been cancelled. |
3. Notification fields
Field | Description |
|---|---|
id | Identifier of the mandate. |
uid | Unique reference for the notification. This is auto-generated. |
recurring_transaction | This field is always set to false. |
event | Refers to the event that triggered this notification. Values: “mandate_created”, “mandate_rejected“, “mandate_triggered”, "mandate_executed", "mandate_execution_rejected", "mandate_settled", “mandate_cancelled”. |
original_sender_iban | IBAN of the sender. |
original_sender_name | Name of the sender. |
original_sender_bank_country | Country of the sender’s bank. |
screen_entities | This field is always empty. |
operation_successful | Ignore this field. |
provider_name | In mandate_created, this field is set to the SDD creditor ID. |
reference_code | In mandate_created, this field reflects the reference provided when the mandate was created. |
provider_reference_code | The IBAN of the merchant. |
response_id | The type of mandate. Values: Null, “Frequent”, “Recurring”, “Limited”, “OneOff“. |
status_code | Date & timestamp of the event. |
external_correlation_id | Ignore this field. |
details | In mandate_created, this field reflects the account identifier provided when the mandate was created. |
manual_reconciliation | Ignore this field. |
currency | Currently, the value is always “EUR”. This is not specified in mandate_rejected and mandate_cancelled. |
amount | The amount of money being sent. The value of this field is always in cents. In mandate_rejected and mandate_cancelled, this field is set to null. |
beneficiary_iban | IBAN of the merchant. This is not specified in mandate_rejected and mandate_cancelled. |
beneficiary_acno | Ignore this field. |
original_sender_address | The address of the sender, if it is known. |
transaction_detail | In mandate_created, this field is not specified. |
4. Final notifications
If you have received 'final' notifications, then any notifications after this should be ignored.
© ISX Financial EU PLC 2024. All rights reserved.