Consultar alertas de fraude

Consulta registros de alertas de fraude en uno de dos modos:

Consulta individual — usa transaction_arn o transaction_reference para identificar una sola transacción. En este modo from y to no son obligatorios.

Consulta por lote / rango de fechas — from y to son obligatorios, y puedes acotar el resultado con los filtros opcionales brand, country, fraud_type y merchant_id.

⚠️ Este reporte solo está disponible para transacciones hechas con tarjetas VISA y MASTERCARD, y solo para la adquirencia de Kushki.
⛔ Este reporte no está disponible para transacciones domésticas en México (PROSA). 🇲🇽

Reglas de precedencia

Si envías transaction_arn y transaction_reference juntos, transaction_arn tiene precedencia y transaction_reference se ignora.

merchant_id no identifica una sola transacción (una sucursal puede tener cero, uno o muchos registros), así que cuando lo usas en una consulta por lote, from y to también son obligatorios. Enviar merchant_id solo, sin from y to, devuelve un error de validación.

Enviar cualquier campo que no forme parte del schema de la petición devuelve un error de validación.

Límite del rango de fechas

El valor de from no puede ser más antiguo que 12 meses desde la fecha de la consulta.

curl --location 'https://api-uat.kushkipagos.com/data/v1/fraud' \ --header 'Private-merchant-id;' \ --header 'Content-Type: application/json' \ --data '{ "transaction_reference": "32160b0d-4591-4691-acc8-44b4c8821627" }'

{ "data": [ { "source_name": "TC40", "transaction_reference": "32160b0d-4591-4691-acc8-44b4c8821627", "transaction_arn": "12710244268000000000007", "customer_id": "20000000104030134000", "merchant_id": "6000000000172710548457113030", "merchant_name": "DEMO STORE", "acquirer_bin": "021193", "masked_pan": "549151XXXXXX7016", "reference_number": "426822110550", "total_amount": 2900, "fraud_type": "00", "incoming_date": 1784127600, "pos_entry_mode": "81" }, { "source_name": "TC40", "transaction_reference": "b7c1f0e2-3a48-4f19-9d21-5c8e7a6b4d30", "transaction_arn": "12710244268000000000012", "customer_id": "20000000104030134000", "merchant_id": "6000000000172710548457113030", "merchant_name": "DEMO STORE", "acquirer_bin": "021193", "masked_pan": "476173XXXXXX4021", "reference_number": "426822110612", "total_amount": 15990, "fraud_type": "6", "incoming_date": 1784214000, "pos_entry_mode": "81", "fraud_amount": "000015990", "fraud_currency_code": "152", "mcc_code": "5812", "purchase_date": "0402" }, { "source_name": "SAFE", "transaction_reference": "6ef09b5a-6ce6-443e-a7dd-c42024e097b2", "transaction_arn": "12231965093000000136802", "customer_id": "20000000104030134000", "merchant_id": "20000328494375849", "merchant_name": "DEMO STORE", "acquirer_bin": "026532", "masked_pan": "533187XXXXXX2822", "reference_number": "509300174610", "total_amount": 34761, "fraud_type": "06", "authorization_code": "556549", "card_present_indicator": "0", "chargeback_indicator": "3", "ecommerce_indicator": "21", "merchant_identifier": "152000006790", "reception_date": "20260409", "transaction_date": "20260402", "transaction_time": "211008", "transaction_amount_usd": "000003666", "transaction_currency_code": "152", "transaction_currency_exponent": "0" } ], "page": 1, "page_size": 100, "total": 3, "total_pages": 1 }

Request

Responses