Consultar alertas de fraude
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/data/v1/fraud
1.
transaction_arn o transaction_reference para identificar una sola transacción. En este modo from y to no son obligatorios.2.
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.
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 uses 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.from no puede ser anterior a 12 meses desde la fecha de la consulta.Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/data/v1/fraud' \
--header 'Private-merchant-id;' \
--header 'Content-Type: application/json' \
--data '{
"transaction_reference": "32160b0d-4591-4691-acc8-44b4c8821627"
}'Response Response Example
200 - Batch response with TC40 and SAFE records combined
{
"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
}Modified at 2026-09-11 14:56:03