[PT] Atualização das APIs de listas: novas rotas e envio do dado no payload / [ES] Actualización de las APIs de listas: nuevas rutas y envío del dato en el payload / [EN] List APIs update: new routes and data sent in the payload

Scheduled for Dec 7, 14:00 - 16:00 GMT-03:00

Scheduled

PRAZO: 07/12/2026. Após esta data, o formato antigo de requisições deixará de funcionar.

As APIs de listas da Konduto estão sendo atualizadas para aumentar a segurança e padronizar as integrações. Clientes que usam as rotas antigas devem adaptar e homologar suas integrações até o prazo.

1. ROTAS DESCONTINUADAS

As rotas /v1/blacklist/... e /v1/whitelist/... serão desativadas. Use as rotas padronizadas:

- Blocklist (negação automática): /v1/blocklist
- Allowlist (aprovação automática): /v1/allowlist
- Reviewlist (envio para revisão): /v1/greylist

2. DADO ENVIADO NO PAYLOAD, NÃO MAIS NA URL

Por melhorias no nosso WAF, o valor da lista não pode mais ir no path da URL. Ele deve ser enviado no corpo da requisição, em todos os métodos (POST, PUT, GET e DELETE) e para todos os tipos de dado.

Formato antigo (será bloqueado):

POST https://api.konduto.com/v1/blacklist/email/example@example.com

Formato novo:

POST https://api.konduto.com/v1/blocklist/email
Content-Type: application/json
{ "value": "example@example.com" }

Exemplos de payload por tipo de dado:

- Email: { "value": "example@example.com" }
- Telefone: { "value": "+551146054321" }
- IP: { "value": "50.1.1.99" }
- Nome: { "value": "Fulano de Tal" }
- BIN (bin_last4): { "value": "555555-1234" }
- CEP (zip): { "value": "55555123" }
- CPF/CNPJ (tax_id): { "value": "841.666.655-53" }

O QUE FAZER

1. Troque blacklist por blocklist e whitelist por allowlist nas URLs.
2. Remova o valor da URL e envie em { "value": "conteúdo" } no corpo da requisição.
3. Teste e homologue a integração antes de 20/11/2026.

DOCUMENTAÇÃO

API de Blocklist: https://docs.konduto.com/reference/api-de-blocklist
API de Allowlist: https://docs.konduto.com/reference/sobre-a-allowlist
API de Reviewlist: https://docs.konduto.com/reference/sobre-a-reviewlist

Dúvidas? Fale com nosso time de suporte.

=============

FECHA LÍMITE: 07/12/2026. Después de esta fecha, el formato anterior de solicitudes dejará de funcionar.

Las APIs de listas de Konduto se están actualizando para aumentar la seguridad y estandarizar las integraciones. Los clientes que usan las rutas anteriores deben adaptar y homologar sus integraciones antes de la fecha límite.

1. RUTAS DESCONTINUADAS

Las rutas /v1/blacklist/... y /v1/whitelist/... serán desactivadas. Use las rutas estandarizadas:

- Blocklist (denegación automática): /v1/blocklist
- Allowlist (aprobación automática): /v1/allowlist
- Reviewlist (envío a revisión): /v1/greylist

2. DATO ENVIADO EN EL PAYLOAD, YA NO EN LA URL

Por mejoras en nuestro WAF, el valor de la lista ya no puede ir en el path de la URL. Debe enviarse en el cuerpo de la solicitud, en todos los métodos (POST, PUT, GET y DELETE) y para todos los tipos de dato.

Formato anterior (será bloqueado):

POST https://api.konduto.com/v1/blacklist/email/example@example.com

Formato nuevo:

POST https://api.konduto.com/v1/blocklist/email
Content-Type: application/json
{ "value": "example@example.com" }

Ejemplos de payload por tipo de dato:

- Email: { "value": "example@example.com" }
- Teléfono: { "value": "+551146054321" }
- IP: { "value": "50.1.1.99" }
- Nombre: { "value": "Fulano de Tal" }
- BIN (bin_last4): { "value": "555555-1234" }
- Código postal (zip): { "value": "55555123" }
- CPF/CNPJ (tax_id): { "value": "841.666.655-53" }

QUÉ HACER

1. Reemplace blacklist por blocklist y whitelist por allowlist en las URLs.
2. Quite el valor de la URL y envíelo como { "value": "contenido" } en el cuerpo de la solicitud.
3. Pruebe y homologue la integración antes del 20/11/2026.

DOCUMENTACIÓN

API de Blocklist: https://docs.konduto.com/reference/api-de-blocklist
API de Allowlist: https://docs.konduto.com/reference/sobre-a-allowlist
API de Reviewlist: https://docs.konduto.com/reference/sobre-a-reviewlist

¿Dudas? Contacte a nuestro equipo de soporte.

=============

DEADLINE: December 7, 2026. After this date, the old request format will stop working.

Konduto's list APIs are being updated to improve security and standardize integrations. Customers using the old routes must adapt and validate their integrations before the deadline.

1. DEPRECATED ROUTES

The /v1/blacklist/... and /v1/whitelist/... routes will be shut down. Use the standardized routes:

- Blocklist (automatic denial): /v1/blocklist
- Allowlist (automatic approval): /v1/allowlist
- Reviewlist (send to review): /v1/greylist

2. DATA SENT IN THE PAYLOAD, NO LONGER IN THE URL

Due to improvements to our WAF, the list value can no longer be included in the URL path. It must be sent in the request body, for all methods (POST, PUT, GET and DELETE) and all data types.

Old format (will be blocked):

POST https://api.konduto.com/v1/blacklist/email/example@example.com

New format:

POST https://api.konduto.com/v1/blocklist/email
Content-Type: application/json
{ "value": "example@example.com" }

Payload examples by data type:

- Email: { "value": "example@example.com" }
- Phone: { "value": "+551146054321" }
- IP: { "value": "50.1.1.99" }
- Name: { "value": "Fulano de Tal" }
- BIN (bin_last4): { "value": "555555-1234" }
- ZIP code (zip): { "value": "55555123" }
- Tax ID, CPF/CNPJ (tax_id): { "value": "841.666.655-53" }

WHAT TO DO

1. Replace blacklist with blocklist and whitelist with allowlist in your URLs.
2. Remove the value from the URL and send it as { "value": "content" } in the request body.
3. Test and validate your integration before November 20, 2026.

DOCUMENTATION

Blocklist API: https://docs.konduto.com/reference/api-de-blocklist
Allowlist API: https://docs.konduto.com/reference/sobre-a-allowlist
Reviewlist API: https://docs.konduto.com/reference/sobre-a-reviewlist

Questions? Contact our support team.

Posted Nov 03, 2026 - 14:52 GMT-03:00

This scheduled maintenance affects: API.