Skip to main content

Decision Notification

Webhook Log: Transaction Decision Notification​

This section describes the behavior of the webhook log generated when a manual decision is made on a transaction. The log captures the details of the decision and sends them to the configured webhooks settings.

Purpose​

The webhook log serves to notify external systems about manual decisions made on transactions. It provides detailed contextual information about the transaction and the decision made.

Webhook Log Request Data Structure​

The following is the structure of the requestData included in the webhook when a manual decision is made on a transaction:

{
  "eventType": "TRANSACTION_APPROVED | TRANSACTION_REJECTED",
  "eventTimestamp": "2025-01-20T10:30:45.123Z",
  "eventVersion": "v1.0",
  "content": {
    "transactionId": "63f9e8a2c4d874001c4e9c42",
    "reason": "Manual review by analyst",
    "analystId": "5fdc9baf9cd824001c4e3d14",
    "timestamp": "2025-01-20T10:30:45.123Z",
    "transactionDetails": {
      "transactionData": {
        "reference": "abc123def456",
        "amount": 1500.0,
        "receiverAccount": "9876543210",
        "senderAccount": "1234567890",
        "isExternalPayment": false,
        "status": "pending",
        "balanceBefore": 2000.0,
        "type": "debit",
        "channel": "mobile",
        "transactionDate": "2025-01-20T09:00:00+00:00",
        "currency": "USD",
        "narration": "Manual review"
      },
      "anonymizedUserData": {
        "uniqueId": "abcd1234-5678-90ef-ghij-klmn4567opqr",
        "isBanned": false,
        "accountType": "individual",
        "isPhoneNumberVerified": true,
        "dateJoined": "2019-03-15",
        "isIdentityVerified": true,
        "state": "Texas",
        "city": "Dallas",
        "country": "United States"
      },
      "location": {
        "latitude": 32.7767,
        "longitude": -96.797
      }
    },
    "additionalInfo": {}
  }
}