API de consulta de remesas

Probala

Escribí una clave y un teléfono, o tocá uno de los casos de ejemplo.

Clave de la remesa

Teléfono de quien escribe

Tipo de documento

Número de documento

Probá el bloqueo. Poné una clave y un documento equivocados y dale consultar seis veces seguidas con el mismo teléfono. A partir del sexto intento la API deja de responder durante una hora, aunque después le mandés los datos correctos.

Qué devuelve y qué no

Devuelve	No devuelve
Estado de la remesa Fecha de envío Fecha de pago Fecha del último cambio Motivo, si está anulada	Nombre del beneficiario Monto Dónde se cobra Datos del remitente

Esa lista corta es una decisión, no un olvido. Entre menos entregue este endpoint, menos sirve el día que alguien consiga una clave ajena. El estado y la fecha resuelven la pregunta real del cliente —«¿ya la puede cobrar?»— sin darle a un tercero nada con que ir a cobrarla.

Cómo se identifica a quien pregunta

El cliente nunca elige el método: lo decide el agente según desde dónde escribe.

Situación	Qué se le pide	Por qué
Escribe desde el teléfono registrado	Solo la clave	El número de WhatsApp ya es el segundo dato, y no cuesta nada: viene en el mensaje.
Escribe desde otro número	Clave y documento	Una clave suelta la puede ver cualquiera sobre un mostrador.
Falla cinco veces en una hora	Nada, queda bloqueado	Un DPI guatemalteco no es secreto. Sin límite, se prueban claves hasta acertar.

Los cinco estados

Estado	Qué significa
EN_PROCESO	Se registró y todavía no está lista para cobrar.
DISPONIBLE	Lista. El beneficiario ya la puede cobrar.
PAGADA	Ya se cobró.
ANULADA	No se va a pagar. Viene acompañada del motivo.
EN_REVISION	Detenida por una revisión. Alguien del equipo tiene que verla.

Cinco y nada más. Si el sistema interno maneja veinte estados, se mapean a estos cinco. Cada estado extra es una respuesta más que el agente tiene que saber explicar, y una duda más para el cliente.

Para el equipo de tecnología

El contrato completo está en openapi.yml, en formato OpenAPI 3.0. Se puede importar en Postman o en Insomnia y probar contra este simulador tal cual.

Lo que hay que construir

Un POST /v1/remesas/consulta que reciba clave, teléfono y documento opcional, y devuelva exactamente la forma de arriba.
Va por POST y no por GET a propósito: la clave y el documento no deben viajar en la URL, porque las URLs quedan escritas en los registros del servidor.
El 401 no distingue entre «esa clave no existe» y «la clave existe pero el documento no coincide». Decirlo le confirmaría a quien está probando que acertó la mitad.
El contador de intentos no puede vivir en la memoria del servidor. Cada petición la puede atender una instancia distinta y el conteo se pierde. Tiene que estar en un almacén compartido: Redis, la base de datos, o lo que ya usen para sesiones.

Simulador preparado por Norma para Oscar A. Jimenez Zavala · 27 de octubre de 2026. Los datos son inventados; ninguna clave de esta página corresponde a una remesa real.