Outgoing webhook notification endpoint

POST

notification

{
  "accountId": "1234567890",
  "branchCode": "752001",
  "customerNumber": "ABCDEFGH123456789",
  "id": "1234567890",
  "status": "ACCOUNT_BLOCKED",
  "subType": "STATUS_CHANGE",
  "type": "ACCOUNT"
}

{
  "accountId": "1234567890",
  "branchCode": "752001",
  "cardId": "801476123",
  "customerNumber": "ABCDEFGH123456789",
  "expiration": {
    "month": 1,
    "year": 2019
  },
  "id": "1234567890",
  "productionEvent": "NCRD",
  "status": "CARD_OK",
  "subType": "PRODUCTION_EVENT",
  "truncatedCardNumber": "123456______4285",
  "type": "CARD"
}

{
  "accountAvailableAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "accountCreditLimit": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "accountId": "1234567890",
  "branchCode": "752001",
  "cardId": "801476123",
  "customerNumber": "ABCDEFGH123456789",
  "ecbRate": "string",
  "feeAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "id": "1234567890",
  "merchant": {
    "id": "64017528",
    "acquirerId": "454109",
    "city": "Helsinki",
    "country": "FIN",
    "mcc": 3016,
    "name": "Airline of the world"
  },
  "originalTransactionId": "1234567890",
  "responseCode": "string",
  "settlementAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "subType": "AUTH",
  "transactionAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "transactionDate": "2020-05-12T13:18:05",
  "transactionId": "1234567890",
  "transactionType": {
    "code": "string"
  },
  "type": "TRANSACTION"
}

{
  "accountScore": "03",
  "branchCode": "752001",
  "cardId": "801476123",
  "cvc2Match": "true",
  "deviceId": "12303E8BEA4D12318291041646948421E70123F308609123",
  "deviceIp": "string",
  "deviceScore": "03",
  "deviceType": {
    "description": "string",
    "value": "string"
  },
  "email": "test@enfuce.com",
  "id": "1234567890",
  "locale": "en_GB",
  "mobileNumber": "+358401234567",
  "oneTimePasscode": "123456",
  "otpDeliveryMethod": "SMS",
  "panSource": "Card added via application",
  "reasonCodes": [
    {
      "description": "string",
      "value": "string"
    }
  ],
  "status": "ACTIVE",
  "subType": "TOKENIZATION_REQUEST",
  "tokenId": 561188600,
  "tokenRequestor": {
    "description": "string",
    "value": "string"
  },
  "tokenRequestorName": "string",
  "tokenUniqueReferenceId": "DNITHE382212342124893123",
  "truncatedCardNumber": "4285",
  "type": "TOKENIZATION",
  "walletProviderRecommendation": "string"
}

{
  "type" : "FRAUD_CASE",
  "id" : "755e22d2-9a95-4d75-b565-556344da9ebd",
  "branchCode" : "12345",
  "subType" : "FINALIZED",
  "fraudCaseId" : "755e22d2-9a95-4d75-b565-556344da9ebd",
  "status" : "CLOSED",
  "cardId" : "123456789",
  "createdTime" : "2025-10-28T11:21:13.307322Z",
  "lastUpdatedTime" : "2025-10-28T11:21:13.307719Z",
  "comment" : "Overall comment to case",
  "resolutionStatus" : "RISK",
  "transactions" : [ {
    "transactionId" : "65465432",
    "customerDecision" : "RISK",
    "customerComment" : "Comments regarding transaction",
    "lastUpdatedTime" : "2025-01-01T00:00:00Z",
    "reason" : {
      "type" : "RISK",
      "code" : "ISSUANCE_OF_A_PAYMENT_ORDER_BY_FRAUDSTER"
    }
  }]
}

{
  "description": "061-Usage Limit '24H_RETAIL' Amount Exceeded",
  "id": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "errorCode": "<string>",
  "errorReason": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "code": "<string>",
  "message": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "errorCode": "<string>",
  "errorReason": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "code": "<string>",
  "message": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "errorCode": "<string>",
  "errorReason": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "code": "<string>",
  "message": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "errorCode": "<string>",
  "errorReason": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "accountId": "1234567890",
  "branchCode": "752001",
  "customerNumber": "ABCDEFGH123456789",
  "id": "1234567890",
  "status": "ACCOUNT_BLOCKED",
  "subType": "STATUS_CHANGE",
  "type": "ACCOUNT"
}

{
  "accountId": "1234567890",
  "branchCode": "752001",
  "cardId": "801476123",
  "customerNumber": "ABCDEFGH123456789",
  "expiration": {
    "month": 1,
    "year": 2019
  },
  "id": "1234567890",
  "productionEvent": "NCRD",
  "status": "CARD_OK",
  "subType": "PRODUCTION_EVENT",
  "truncatedCardNumber": "123456______4285",
  "type": "CARD"
}

{
  "accountAvailableAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "accountCreditLimit": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "accountId": "1234567890",
  "branchCode": "752001",
  "cardId": "801476123",
  "customerNumber": "ABCDEFGH123456789",
  "ecbRate": "string",
  "feeAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "id": "1234567890",
  "merchant": {
    "id": "64017528",
    "acquirerId": "454109",
    "city": "Helsinki",
    "country": "FIN",
    "mcc": 3016,
    "name": "Airline of the world"
  },
  "originalTransactionId": "1234567890",
  "responseCode": "string",
  "settlementAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "subType": "AUTH",
  "transactionAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "transactionDate": "2020-05-12T13:18:05",
  "transactionId": "1234567890",
  "transactionType": {
    "code": "string"
  },
  "type": "TRANSACTION"
}

{
  "accountScore": "03",
  "branchCode": "752001",
  "cardId": "801476123",
  "cvc2Match": "true",
  "deviceId": "12303E8BEA4D12318291041646948421E70123F308609123",
  "deviceIp": "string",
  "deviceScore": "03",
  "deviceType": {
    "description": "string",
    "value": "string"
  },
  "email": "test@enfuce.com",
  "id": "1234567890",
  "locale": "en_GB",
  "mobileNumber": "+358401234567",
  "oneTimePasscode": "123456",
  "otpDeliveryMethod": "SMS",
  "panSource": "Card added via application",
  "reasonCodes": [
    {
      "description": "string",
      "value": "string"
    }
  ],
  "status": "ACTIVE",
  "subType": "TOKENIZATION_REQUEST",
  "tokenId": 561188600,
  "tokenRequestor": {
    "description": "string",
    "value": "string"
  },
  "tokenRequestorName": "string",
  "tokenUniqueReferenceId": "DNITHE382212342124893123",
  "truncatedCardNumber": "4285",
  "type": "TOKENIZATION",
  "walletProviderRecommendation": "string"
}

{
  "type" : "FRAUD_CASE",
  "id" : "755e22d2-9a95-4d75-b565-556344da9ebd",
  "branchCode" : "12345",
  "subType" : "FINALIZED",
  "fraudCaseId" : "755e22d2-9a95-4d75-b565-556344da9ebd",
  "status" : "CLOSED",
  "cardId" : "123456789",
  "createdTime" : "2025-10-28T11:21:13.307322Z",
  "lastUpdatedTime" : "2025-10-28T11:21:13.307719Z",
  "comment" : "Overall comment to case",
  "resolutionStatus" : "RISK",
  "transactions" : [ {
    "transactionId" : "65465432",
    "customerDecision" : "RISK",
    "customerComment" : "Comments regarding transaction",
    "lastUpdatedTime" : "2025-01-01T00:00:00Z",
    "reason" : {
      "type" : "RISK",
      "code" : "ISSUANCE_OF_A_PAYMENT_ORDER_BY_FRAUDSTER"
    }
  }]
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Notification information. The fields are different depending which type of notification it is.

accountId

string

required

accountId that is representing this notification

Example:

"1234567890"

customerNumber

string

required

Customer number that is representing this notification, typically card holder and is the number set as external identifier when customer is created

Example:

"ABCDEFGH123456789"

subType

enum<string>

required

Tells in more detail about what is changed

Available options:

CREATED,

REMINDER_STATUS_CHANGE,

STATUS_CHANGE

string

required

Unique ID for a notification assigned by Enfuce

Example:

"1234567890"

type

enum<string>

required

Corresponds to the entity represented in other parts of Enfuce API. Note: The INVOICE enum is available only for fleet cards.

Available options:

ACCOUNT,

CARD,

PIN,

TRANSACTION,

AUTHORIZATION_HOLD,

TOKENIZATION,

EMVSCRIPT,

INVOICE,

FRAUD_CASE

reminderStatus

enum<string>

Available options:

WAIT,

REMINDER1_SENT,

CARD_BLOCKED,

REMINDER2_SENT,

REMINDER3_SENT,

REMINDER4_SENT,

REMINDER5_SENT,

REMINDER6_SENT,

REMINDER7_SENT,

SENT_TO_COLLECTION,

STOPPED,

DONE

status

enum<string>

Available options:

ACCOUNT_BLOCKED,

ACCOUNT_COLLECTION,

ACCOUNT_OK,

ACCOUNT_TO_CLOSE,

ACCOUNT_CLOSED,

ACCOUNT_AUTO_CLOSED

branchCode

string

Your Institution Identifier assigned by Enfuce. For example, this can be used to determine the Sender ID for SMS messages.

Example:

"752001"

Response

A new notification event created

description

string

When a payment is declined, a response description is returned, if available, providing more context on why the transaction failed. This includes a return code and a brief explanation. If multiple issues cause the decline, only one response description is sent; the most recent reason for decline is returned. If the payment is successful, the resourceResponse attribute is returned with null value.

Example:

"061-Usage Limit '24H_RETAIL' Amount Exceeded"

string

Will contain the ID of the resource that has been created or updated

⌘I

{
  "accountId": "1234567890",
  "branchCode": "752001",
  "customerNumber": "ABCDEFGH123456789",
  "id": "1234567890",
  "status": "ACCOUNT_BLOCKED",
  "subType": "STATUS_CHANGE",
  "type": "ACCOUNT"
}

{
  "accountId": "1234567890",
  "branchCode": "752001",
  "cardId": "801476123",
  "customerNumber": "ABCDEFGH123456789",
  "expiration": {
    "month": 1,
    "year": 2019
  },
  "id": "1234567890",
  "productionEvent": "NCRD",
  "status": "CARD_OK",
  "subType": "PRODUCTION_EVENT",
  "truncatedCardNumber": "123456______4285",
  "type": "CARD"
}

{
  "accountAvailableAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "accountCreditLimit": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "accountId": "1234567890",
  "branchCode": "752001",
  "cardId": "801476123",
  "customerNumber": "ABCDEFGH123456789",
  "ecbRate": "string",
  "feeAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "id": "1234567890",
  "merchant": {
    "id": "64017528",
    "acquirerId": "454109",
    "city": "Helsinki",
    "country": "FIN",
    "mcc": 3016,
    "name": "Airline of the world"
  },
  "originalTransactionId": "1234567890",
  "responseCode": "string",
  "settlementAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "subType": "AUTH",
  "transactionAmount": {
    "amount": 3.14,
    "currency": "EUR"
  },
  "transactionDate": "2020-05-12T13:18:05",
  "transactionId": "1234567890",
  "transactionType": {
    "code": "string"
  },
  "type": "TRANSACTION"
}

{
  "accountScore": "03",
  "branchCode": "752001",
  "cardId": "801476123",
  "cvc2Match": "true",
  "deviceId": "12303E8BEA4D12318291041646948421E70123F308609123",
  "deviceIp": "string",
  "deviceScore": "03",
  "deviceType": {
    "description": "string",
    "value": "string"
  },
  "email": "test@enfuce.com",
  "id": "1234567890",
  "locale": "en_GB",
  "mobileNumber": "+358401234567",
  "oneTimePasscode": "123456",
  "otpDeliveryMethod": "SMS",
  "panSource": "Card added via application",
  "reasonCodes": [
    {
      "description": "string",
      "value": "string"
    }
  ],
  "status": "ACTIVE",
  "subType": "TOKENIZATION_REQUEST",
  "tokenId": 561188600,
  "tokenRequestor": {
    "description": "string",
    "value": "string"
  },
  "tokenRequestorName": "string",
  "tokenUniqueReferenceId": "DNITHE382212342124893123",
  "truncatedCardNumber": "4285",
  "type": "TOKENIZATION",
  "walletProviderRecommendation": "string"
}

{
  "type" : "FRAUD_CASE",
  "id" : "755e22d2-9a95-4d75-b565-556344da9ebd",
  "branchCode" : "12345",
  "subType" : "FINALIZED",
  "fraudCaseId" : "755e22d2-9a95-4d75-b565-556344da9ebd",
  "status" : "CLOSED",
  "cardId" : "123456789",
  "createdTime" : "2025-10-28T11:21:13.307322Z",
  "lastUpdatedTime" : "2025-10-28T11:21:13.307719Z",
  "comment" : "Overall comment to case",
  "resolutionStatus" : "RISK",
  "transactions" : [ {
    "transactionId" : "65465432",
    "customerDecision" : "RISK",
    "customerComment" : "Comments regarding transaction",
    "lastUpdatedTime" : "2025-01-01T00:00:00Z",
    "reason" : {
      "type" : "RISK",
      "code" : "ISSUANCE_OF_A_PAYMENT_ORDER_BY_FRAUDSTER"
    }
  }]
}

{
  "description": "061-Usage Limit '24H_RETAIL' Amount Exceeded",
  "id": "<string>"
}

{
  "code": "<string>",
  "message": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "errorCode": "<string>",
  "errorReason": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "code": "<string>",
  "message": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "errorCode": "<string>",
  "errorReason": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "code": "<string>",
  "message": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "errorCode": "<string>",
  "errorReason": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "code": "<string>",
  "message": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "errorCode": "<string>",
  "errorReason": "<string>",
  "timestamp": "2023-11-07T05:31:56Z"
}