Consultar alertas de fraude

POST

/data/v1/fraud

Consulta registros de alertas de fraude en dos modos posibles:

Consulta individual — usando transaction_arn o transaction_reference para identificar una transacción única. En este modo from/to no son obligatorios.

Consulta batch / por rango — usando from y to obligatoriamente, con filtros opcionales de brand, country, fraud_type y merchant_id.

Reglas de prioridad:

Si se envían transaction_arn y transaction_reference a la vez,
transaction_arn tiene prioridad y transaction_reference se
ignora.

merchant_id no identifica una transacción única (un branch puede
tener 0, 1 o muchos registros); si se usa en consulta batch,
from y to también son obligatorios. Enviar solo merchant_id
sin from/to produce error.

Enviar en el body cualquier campo no incluido en el esquema
también produce un error de validación.

Request

Authorization

API Key

Add parameter in header

Private-merchant-id

Example:

Private-merchant-id: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Consulta exitosa.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

cURL

Consulta individual por transaction_referenceConsulta batch con filtros (brand, country, rango de fechas)Consulta batch con varios merchant_id (branches)

curl --location 'https://api-uat.kushkipagos.com/data/v1/fraud' \
--header 'Private-merchant-id: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "transaction_reference": "ba353f86-1ef4-test-test-test"
}'

Response Example

200 - Respuesta batch con registros TC40 y SAFE combinados

{
    "data": [
        {
            "source_name": "TC40",
            "transaction_reference": "32160b0d-4591-4691-acc8-44b4c8821627",
            "transaction_arn": "12710244268000000000007",
            "customer_id": "20000000104030134000",
            "merchant_id": "6000000000172710548457113030",
            "merchant_name": "PEAKY BLINDERS COLOMBIA",
            "acquirer_bin": "021193",
            "masked_pan": "549151XXXXXX7016",
            "reference_number": "426822110550",
            "total_amount": 2900,
            "fraud_type": "00",
            "incoming_date": 1784127600,
            "pos_entry_mode": "81"
        },
        {
            "source_name": "SAFE",
            "transaction_reference": "6ef09b5a-6ce6-443e-a7dd-c42024e097b2",
            "transaction_arn": "12231965093000000136802",
            "customer_id": "20000000104030134000",
            "merchant_id": "20000328494375849",
            "merchant_name": "20004375749838594",
            "acquirer_bin": "026532",
            "masked_pan": "533187XXXXXX2822",
            "reference_number": "509300174610",
            "total_amount": 34761,
            "fraud_type": "06",
            "authorization_code": "556549",
            "card_present_indicator": "0",
            "chargeback_indicator": " ",
            "ecommerce_indicator": "21",
            "merchant_identifier": "152000006790   ",
            "reception_date": "20260409",
            "transaction_date": "20250402",
            "transaction_time": "211008",
            "transaction_amount_usd": "000003666",
            "transaction_currency_code": "152",
            "transaction_currency_exponent": "0"
        }
    ],
    "page": 1,
    "page_size": 100,
    "total": 9,
    "total_pages": 1
}

Modified at 2026-08-06 21:48:42

Fraud Report

API Raw Card Present Payments