Consultar chargebacks

https://api-uat.kushkipagos.com

POST

/data/v1/chargebacks/search

Devuelve una lista paginada de chargebacks asociados al comercio autenticado.

Objeto filters

Usa el objeto filters para acotar los resultados por transaction_date, request_date, chargeback_status, country_name, chargeback_type, ticket_code o chargeback_ticket_code.

Filtro time

El filtro time es obligatorio y funciona así:

Envía transaction_date o request_date

Si envías ambos, la API devuelve un error.

El rango de fechas máximo permitido es de 3 meses.

Arreglo fields

El arreglo fields te permite solicitar campos adicionales además del conjunto por defecto de la respuesta. Si omites fields, solo se devuelven los campos estándar.

Límite: El valor máximo permitido para page_size en esta versión es de 100 registros por página.

Request

Authorization

API Key

Add parameter in header

private-merchant-id

Example:

private-merchant-id: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Consulta exitosa. Devuelve la lista paginada de chargebacks que coinciden con los filtros aplicados.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Query with default fieldsQuery with filters and additional fields

curl --location '/data/v1/chargebacks/search' \
--header 'private-merchant-id: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "filters": {
        "time": {
            "transaction_date": {
                "from": "2026-02-01",
                "to": "2026-02-28"
            }
        }
    },
    "pagination": {
        "page": 1,
        "page_size": 20
    }
}'

Response Example

200 - default

{
    "data": [
        {
            "id": "0c2dac27-ba93-4d82-86ec-fd960186cb5e",
            "chargeback_ticket_code": "1770146347760977",
            "merchant_name": "AGREGADOR",
            "chargeback_status": "INITIALIZED",
            "reason_code": "4834",
            "request_amount": 2325.3,
            "currency_code": "USD",
            "transaction_date": "2026-01-08T22:24:09.611Z",
            "request_date": "2026-02-01T00:00:00Z",
            "deadline_representation_date": "2026-02-15T00:00:00Z",
            "deadline_resolution_date": "2026-06-01T00:00:00Z",
            "risk_level": "MEDIUM"
        },
        {
            "id": "1a3ebc38-cd04-5e93-97fd-ge071297dc6f",
            "chargeback_ticket_code": "1770146347359650",
            "merchant_name": "AGREGADOR",
            "chargeback_status": "INITIALIZED",
            "reason_code": "4853",
            "request_amount": 13300,
            "currency_code": "USD",
            "transaction_date": "2025-11-15T01:16:42.015Z",
            "request_date": "2026-02-01T00:00:00Z",
            "deadline_representation_date": "2026-02-15T00:00:00Z",
            "deadline_resolution_date": "2026-06-01T00:00:00Z",
            "risk_level": "MEDIUM"
        },
        {
            "id": "2b4fcd49-de15-6fa4-a8ge-hf182308ed7g",
            "chargeback_ticket_code": "NO_INFO",
            "merchant_name": "CRUCO CAPITAL HUMANO 4",
            "chargeback_status": "NOT_MARKABLE",
            "reason_code": "4837",
            "request_amount": 1165.13,
            "currency_code": "USD",
            "transaction_date": "2026-01-22T18:48:57Z",
            "request_date": "2026-02-01T00:00:00Z",
            "deadline_representation_date": "2026-02-15T00:00:00Z",
            "deadline_resolution_date": "2026-06-01T00:00:00Z",
            "risk_level": "HIGH"
        }
    ],
    "page": 1,
    "page_size": 20,
    "total": 19990,
    "total_pages": 1000
}

Modified at 2026-09-11 15:02:28

Chargebacks

Solicitar exportación de chargebacks

Consultar chargebacks

Objeto filters#

Filtro time#

Arreglo fields#

Request

Responses

Objeto filters

Filtro time

Arreglo fields