Chargebacks
Buscar chargebacks
POST /data/v1/chargebacks/search con un objeto de filtros y la configuración de paginación.Estructura del request
{
"filters": {
"time": {
"transaction_date": {
"from": "2026-01-01",
"to": "2026-03-31"
}
},
"chargeback_status": ["INITIALIZED", "APPROVAL"],
"chargeback_type": ["FRAUD"]
},
"fields": ["ticket_code", "processor_name", "reason_description"],
"pagination": {
"page": 1,
"page_size": 20
}
}Opciones de filtro
| Filtro | Tipo | Descripción |
|---|---|---|
filters.time.transaction_date | Object | Filtra por la fecha de la transacción original (from / to, ISO 8601). |
filters.time.request_date | Object | Filtra por la fecha de solicitud del chargeback (from / to). |
filters.chargeback_status | Array | INITIALIZED, APPROVAL, DECLINED, NOT_MARKABLE. |
filters.chargeback_type | Array | ADMINISTRATIVE o FRAUD. |
filters.country_name | Array | Filtra por país del comercio (por ejemplo, ["PERU"]). |
filters.card_country_name | Array | Filtra por el país emisor de la tarjeta. |
filters.chargeback_ticket_code | String | Busca un chargeback específico por su número de ticket. |
Campos adicionales
fields para pedir columnas de datos adicionales:ticket_code, operation_id, transaction_reference, merchant_code, business_unit, approved_transaction_amount, transaction_type, transaction_status, chargeback_type, reason_description, processor_name, issuing_bank, card_country_name, country_name, masked_credit_card, last_four_digit_code, y más.Respuesta
data con objetos de chargeback. Campos por defecto de cada chargeback:| Campo | Descripción |
|---|---|
id | ID único del registro de chargeback. |
chargeback_ticket_code | Número de ticket del chargeback. |
merchant_name | Nombre del comercio. |
chargeback_status | Estado actual: INITIALIZED, APPROVAL, DECLINED o NOT_MARKABLE. |
reason_code | Código de motivo de la disputa, definido por la red de tarjetas. |
request_amount | Monto disputado. |
currency_code | Moneda de la transacción (PEN o USD). |
transaction_date | Fecha de la transacción original (ISO 8601). |
request_date | Fecha en que se presentó el chargeback. |
deadline_representation_date | Fecha límite para que el comercio envíe la evidencia. |
deadline_resolution_date | Fecha límite final de resolución. |
risk_level | HIGH, MEDIUM o LOW. |
Exportar chargebacks
POST /data/v1/chargebacks/export para iniciar una exportación asíncrona. El body del request sigue la misma estructura que el endpoint de búsqueda, con un array webhooks adicional.Cómo funciona
1.
id único.2.
3.
POST a cada URL de tu array webhooks con el link de descarga y su timestamp de expiración.Ejemplo de request
{
"filters": {
"time": {
"transaction_date": {
"from": "2026-01-01",
"to": "2026-03-31"
}
}
},
"fields": ["ticket_code", "processor_name", "masked_credit_card"],
"pagination": {
"page": 1,
"page_size": 500
},
"webhooks": ["https://yoursite.com/kushki/chargebacks/export"]
}Respuesta
{
"id": "1339b164-9298-4ea1-a52a-a9c053879194"
}id para correlacionarlo con la notificación del webhook o para reportar problemas de entrega al soporte de Kushki.Autenticación
Usar la API
🟢 Producción
🧪 Sandbox (UAT)
https://api.kushkipagos.com/Endpoints disponibles
¿Tienes una sugerencia sobre esta documentación? Contáctanos.
Modified at 2026-09-07 16:54:51