AML processes

AML_PERSON_SUBPROCESS_CREATED

• The AML API triggers the AML_PERSON_SUBPROCESS_CREATED event when a new person is created at Person API, and its status is set to PENDING.

• Event parameters are eventTypeCode/routing_code: ext.aml-subprocess.waiting-for-external-provider-person.

{
  "notificationId": "ID-9999",
  "notificationTypeCode": "AML_PERSON_SUBPROCESS_CREATED",
  "destination": "https://hooks.slack.com/services/TQ12LTR432rfdsfsdg",
  "originalMessageDateTime": "2024-12-16T11:18:19.955Z",
  "data": {
    "messageDTime": "2022-07-08T09:04:37.108561Z",
    "amlProcessId": "ID-1000",
    "amlSubprocessId": "A000000001000",
    "personId": "ID-1000"
  }
}

AML_SUBPROCESS_CREATED

• The AML API triggers the AML_SUBPROCESS_CREATED event when the payment AML subprocess starts and payment is set to WAITING_FOR_AML status.

• Event parameters are eventTypeCode/routing_code: ext.aml.subprocess.created.

{
  "notificationId": "ID-9999",
  "notificationTypeCode": "AML_SUBPROCESS_CREATED",
  "destination": "https://hooks.slack.com/services/TQ12LTR432rfdsfsdg",
  "originalMessageDateTime": "2024-09-13T11:15:39.294Z",
  "data": {
    "messageDTime": "2022-07-08T09:04:37.108561Z",
    "amlProcessId": "ID-1000",
    "amlSubprocessId": "A000000001000",
    "paymentId": "PAYM-1000",
    "paymentTypeCode": "ACC2SEPA",
    "accountId": "ID-1000",
    "amount": {
      "amount": 1.22,
      "currencyCode": "EUR"
    },
    "directionCode": "OUT",
    "postingDate": "2022-07-08",
    "effectiveDate": "2022-07-08",
    "details": "TEST payment 123",
    "referenceNumber": "TEST payment 321",
    "statusCode": "WAITING_FOR_EXTERNAL_PROVIDER",
    "paymentParties": "Payment party information",
    "exchangeRate": "Exchange rate information",
    "initialBalance": {
      "amount": 1.22,
      "currencyCode": "EUR"
    },
    "transactionTypeCode": "OUT_PAYMENT_SETTLED",
    "feeTransactionTypeCode": "ACC2SEPA_FEE",
    "feeAmount": {
      "amount": 1.22,
      "currencyCode": "EUR"
    },
    "source": {
      "sourceName": "PAYMENT",
      "sourceRef": "ID-181922"
    },
    "residencyCountryCode": "EE",
    "endToEndId": "ID-1000",
    "contractSource": {
      "sourceName": "LOAN.CONTRACT",
      "sourceRef": "ID-181922",
      "contractNumber": "1122241515"
    },
    "paymentServiceProviderCode": "BC",
    "fxPaymentFlag": true,
    "fixedSide": "BUY",
    "coverAmount": {
      "amount": 1.22,
      "currencyCode": "EUR"
    },
    "paymentAmount": {
      "amount": 1.22,
      "currencyCode": "EUR"
    },
    "fxPaymentExchangeRate": 0.86,
    "paymentSchemeElements": "Payment scheme elements information",
    "purposeCode": "SALA",
    "preferredPaymentScheme": "SEPA_INSTANT",
    "selectedPaymentScheme": "SEPA_INSTANT"
  }
}

AML_SUBPROCESS_CREATED_COLLECTION

• The AML API triggers the AML_SUBPROCESS_CREATED_COLLECTION event when the creation of the direct debit collection initiates AML service, and the AML subprocess sets the collection status to WAITING_FOR_EXTERNAL_PROVIDER.

• Event parameters are eventTypeCode/routing_code: ext.aml.collection-subprocess.created.

{
  "notificationId": "ID-9999",
  "notificationTypeCode": "AML_SUBPROCESS_CREATED_COLLECTION",
  "destination": "https://hooks.slack.com/services/TQ12LTR432rfdsfsdg",
  "originalMessageDateTime": "2024-12-16T11:38:42.706Z",
  "data": {
    "messageDTime": "2022-07-08T00:00:00Z",
    "amlProcessId": "ID-1000",
    "amlSubprocessId": "A000000001000",
    "collectionId": "ID-1000",
    "collectionTypeCode": "OUT_SEPA",
    "directionCode": "OUT",
    "statusCode": "WAITING_FOR_EXTERNAL_PROVIDER",
    "money": {
      "amount": 1.22,
      "currencyCode": "EUR"
    },
    "dueDate": "2022-07-08",
    "sequenceTypeCode": "FRST",
    "collectionDetails": "Details",
    "collectionReferenceNumber": "12345",
    "mandate": {
      "mandateReferenceNumber": "12345678",
      "mandateSignatureDate": "2022-07-08"
    },
    "creditorSchemeIdentification": "EE01285",
    "serviceProviderCode": "SEPA",
    "channelCode": "SYSTEM",
    "insertedDateTime": "2023-03-08T12:05:01.622775Z",
    "collectionSchemeCode": "SEPA",
    "source": {
      "sourceName": "PAYMENT",
      "sourceRef": "ID-181922"
    },
    "postingDate": "2022-07-08",
    "settlementDate": "2022-07-08",
    "requestDate": "2022-07-08",
    "collectionParties": [
      {
        "name": "Airport Hotel Gmbh",
        "typeCode": "CREDITOR",
        "accountNumber": {
          "value": "DE89370400440532013000",
          "type": "IBAN"
        },
        "accountNumberCountryCode": "EE",
        "financialInstitutionId": {
          "value": "MAINDE2XXXX",
          "type": "BIC"
        },
        "address": {
          "street1": "Hugo-Eckener-Ring 1",
          "street2": "Apartment Number 40",
          "cityCounty": "Frankfurt am Main",
          "stateRegion": "Hesse",
          "zip": "60549",
          "countryCode": "DE",
          "addressLine": "Hugo-Eckener-Ring 1, Frankfurt am Main, Hesse, 60549, Germany",
          "addressTypeCode": "R"
        },
        "accountId": "ID-1000",
        "personId": "ID-1000",
        "personTypeCode": "P"
      }
    ],
    "sepaScheme": "B2B",
    "residencyCountryCode": "EE",
    "instrumentCode": "PAYMENT.ACC2COLLECTION",
    "mandateId": "ID-1000"
  }
}

AML_PAYMENT_TEMPLATE_SUBPROCESS_CREATED

• The payment API triggers the AML_PAYMENT_TEMPLATE_SUBPROCESS_CREATED event when a payment template is created and the payment status is changed to WAITING_FOR_AML.

• Event parameters are eventTypeCode/routing_code: ext.aml.payment-template-subprocess.created.

Note: This event only occurs if the AML_CHECK_PAYMENT_TEMPLATE system property is set to Yes and an external AML service provider is activated for the payment template screening.

{
  "notificationId": "ID-9999",
  "notificationTypeCode": "AML_PAYMENT_TEMPLATE_SUBPROCESS_CREATED",
  "destination": "https://hooks.slack.com/services/TQ12LTR432rfdsfsdg",
  "originalMessageDateTime": "2024-09-13T10:58:10.947Z",
  "data": {
    "messageDTime": "2022-07-08T09:04:37.108561Z",
    "amlProcessId": "ID-1000",
    "amlSubprocessId": "A000000001000",
    "accountId": "ID-1000",
    "amount": {
      "amount": 1.22,
      "currencyCode": "EUR"
    },
    "bankingDate": "2022-07-08",
    "details": "TEST payment 123",
    "paymentTypeCode": "ACC2SEPA",
    "referenceNumber": "TEST payment 321",
    "statusCode": "WAITING_FOR_AML",
    "templateId": "ID-1000",
    "templateName": "Lunch payment",
    "templateParties": "Payment template party information",
    "templateSchemeElements": "Payment template scheme elements information"
  }
}

AML_PAYMENT_RESULTS_PUBLISHED

• The AML API triggers the AML_PAYMENT_RESULTS_PUBLISHED event when the payment AML process is completed, and the AML process status is set to APPROVED, DECLINED, or REVIEW.

• Event parameters are eventTypeCode/routing_code: ext.aml-process.payment-results.published.

{
  "notificationId": "ID-9999",
  "notificationTypeCode": "AML_PAYMENT_RESULTS_PUBLISHED",
  "destination": "https://hooks.slack.com/services/TQ12LTR432rfdsfsdg",
  "originalMessageDateTime": "2024-09-13T11:06:32.924Z",
  "data": {
    "amlProcessId": "ID-1000",
    "amlProcessResultCode": "APPROVED",
    "subProcessResultReasons": "LEGAL_REASON, CODE_RED",
    "source": {
      "sourceName": "PAYMENT",
      "sourceRef": "ID-181922"
    }
  }
}