Colección de Postman
Hay una colección y un environment de Postman generados desde el OpenAPI de la API, para que no se desactualicen:
Impórtalos en Postman y ajusta las variables del environment:
| Variable | Valor |
|---|---|
baseUrl | Dirección del API (local: http://localhost:18083) |
keycloakUrl | Solo si pides el token directo a Keycloak (local: http://localhost:18081); con POST /api/auth/token no se usa |
merchantId / merchantSecret | Tus credenciales |
token | Lo llena la petición Obtener token (guarda access_token) |
Además hay una colección en forma de flujo para integrar una app de pago con un comercio (token, links, webhook del comercio, transferencia entre cuentas Crezcamos y confirmación): mosi-gran-kiosko.postman_collection.json. Pide el token con POST /api/auth/token; no usa Keycloak. Esta no se regenera: se mantiene a mano.
Regenerar
Tras actualizar el snapshot del OpenAPI (scripts/sync-openapi.sh):
cd developers
npm run postman
Esto reescribe los dos archivos de static/postman/.
La colección cubre los endpoints del spec. Los webhooks entrantes y la firma de webhooks salientes se prueban con los curl y los vectores de esas páginas.