Solicitar exportación de chargebacks
Developing
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
POST
/data/v1/chargebacks/export
200 OK con un id único. Cuando el archivo se ha generado y almacenado, Kushki envía una notificación POST a cada URL configurada en el array webhooks, incluyendo el link de descarga y su timestamp de expiración.POST /data/v1/chargebacks/search, con el agregado del campo webhooks.Nota: La URL de descarga es una URL prefirmada de S3 válida por 4 horas desde el momento de la generación. Revisa expiration_timestampen la notificación del webhook antes de intentar la descarga.
Seguridad del webhook
| Cabecera | Descripción |
|---|---|
X-Kushki-Id | Timestamp Unix (13 dígitos, milisegundos) del momento en que se envió la notificación. |
X-Kushki-Signature | Firma HMAC SHA256 de private-merchant-id|request|X-Kushki-Id. El secreto de firma es el propio private-merchant-id del comercio. |
HMAC-SHA256({private-merchant-id}, "{private-merchant-id}|{request}|{X-Kushki-Id}")X-Kushki-Signature. Si coinciden, la notificación es auténtica.Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/data/v1/chargebacks/export' \
--header 'private-merchant-id: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"filters": {
"time": {
"request_date": {
"from": "2026-01-15",
"to": "2026-03-15"
}
}
},
"webhooks": [
"https://yoursite.com/webhooks/chargebacks"
]
}'Response Response Example
200 - Example 1
{
"id": "1339b164-9298-4ea1-a52a-a9c053879194"
}Modified at 2026-09-11 15:09:52