Rescore Transaction

Reprocess an existing transaction through the fraud scoring rules. Useful when rules have changed or when manual review is complete and a fresh score is needed.

Flat field format

Transaction fields are sent flat at the root of the request body — the same format as Process Transaction. Do not wrap them in a mappedFields object.

API Call

Send an HTTP POST request to:

POST /api/v1/transactions/{transactionServiceKey}/rescore

Parameters

Parameter	Location	Required	Description
transactionServiceKey	path	✅	Identifier of the transaction service that defines which rules to run
referenceId	body	✅	Your internal transaction ID — must match an existing transaction
customerId	body	✅	referenceId of the customer
amount	body	—	Transaction amount. Optional — not all module services require it
(any other key)	body	—	Any additional transaction fields, sent flat at the root

Request

{
  "referenceId": "a4a4f61d-bd1f-4e8a-b4c2-4c36f9f3a315",
  "customerId": "550",
  "amount": 800,
  "transactionSubType": "0",
  "merchantId": "12345",
  "bnfName": "Name Surname",
  "remitterName": "Name Surname",
  "cardNumber": "1234567891",
  "deviceId": "123456",
  "recognizedDevice": "0"
}

Response — Successful

{
  "status": 200,
  "message": "Transaction processed successfully",
  "data": {
    "id": "fbdacaf2-1e0a-4292-93d3-09c4f3566328",
    "referenceId": "a4a4f61d-bd1f-4e8a-b4c2-4c36f9f3a315",
    "amount": 800,
    "score": 150,
    "status": "Rejected",
    "organizationId": "0b042d50-fa8d-44d6-b3e5-02ace4c24f8b",
    "customerId": 3,
    "createdAt": "2025-07-04T05:54:37.185Z",
    "updatedAt": "2025-07-04T05:54:37.185Z",
    "externalId": "326",
    "assignedToUserId": null,
    "moduleApiId": 4,
    "meta": {
      "processId": "json"
    },
    "rules": [
      {
        "rule": {
          "id": "f0730189-62f7-4bf8-acad-27f15ad6b892",
          "name": "Merchant monthly limit",
          "description": null,
          "status": "ACTIVE",
          "score": 0
        }
      },
      {
        "rule": {
          "id": "dcb9cb62-742f-4126-b66e-d0f123b76a75",
          "name": "[Account] First 5 outbound",
          "description": null,
          "status": "ACTIVE",
          "score": 50
        }
      },
      {
        "rule": {
          "id": "d18ba355-bcaa-461c-bbbb-e60902d080cf",
          "name": "[73] Number of transactions performed at the same merchant",
          "description": null,
          "status": "ACTIVE",
          "score": 50
        }
      },
      {
        "rule": {
          "id": "fbcb7fac-0ae2-4dab-a6ae-f940ae427ba5",
          "name": "[72] Value of loads performed at the same agent daily and over time",
          "description": null,
          "status": "ACTIVE",
          "score": 50
        }
      },
      {
        "rule": {
          "id": "17686f40-7bac-4e15-8a70-2c640c99cc78",
          "name": "[AML] Outbound - Criminals and Interpol Check",
          "description": null,
          "status": "ACTIVE",
          "score": 0
        }
      },
      {
        "rule": {
          "id": "cea949db-7c66-4af2-9536-79aca6855d1e",
          "name": "[AML] Outbound - PEP Check",
          "description": null,
          "status": "ACTIVE",
          "score": 0
        }
      },
      {
        "rule": {
          "id": "e7aee336-831a-4203-82d3-e23fc24856a9",
          "name": "[AML] In/Out - Check Beneficiary/Remitter - recordType: Sanctioned",
          "description": null,
          "status": "ACTIVE",
          "score": 0
        }
      }
    ],
    "moduleApi": {
      "id": 4,
      "name": "Global",
      "serviceIdentifier": "json"
    },
    "mappedFields": [
      {
        "value": "0",
        "TransactionFieldDefinition": { "aliases": "transactionSubType" }
      },
      {
        "value": "12345",
        "TransactionFieldDefinition": { "aliases": "merchantId" }
      },
      {
        "value": "Name Surname",
        "TransactionFieldDefinition": { "aliases": "bnfName" }
      },
      {
        "value": "Name Surname",
        "TransactionFieldDefinition": { "aliases": "remitterName" }
      },
      {
        "value": "1234567891",
        "TransactionFieldDefinition": { "aliases": "cardNumber" }
      },
      {
        "value": "123456",
        "TransactionFieldDefinition": { "aliases": "deviceId" }
      },
      {
        "value": "0",
        "TransactionFieldDefinition": { "aliases": "recognizedDevice" }
      }
    ],
    "assignedToUser": null,
    "customer": {
      "referenceId": "550",
      "name": "Sylvernus Akubo"
    }
  },
  "code": "info"
}