# EvePay

> Pasarela de pagos para Colombia. Un comercio cobra creando un cobro desde su servidor, mandando al comprador a pagar, y despachando cuando llega el webhook. Toda la documentación está también en Markdown: cambia `.md` por la ruta de cualquier página.

Tres cosas que se aciertan mal si nadie las dice:

- En pesos colombianos no hay centavos: `montoMinor: 89000` son $ 89.000.
- La llave `evpk_*` es secreta y va en el servidor, nunca en el navegador.
- El pedido se despacha con el webhook, no cuando el comprador vuelve a la tienda.

## Integrar

- [Cómo funciona](https://docs.evetev.com/inicio.md): Los tres pasos de una integración y un cobro completo en cURL, PHP y Node.
- [Antes de empezar](https://docs.evetev.com/empezar.md): Registrar el sitio y la página de retorno, y conseguir la llave de integración.
- [Crear un cobro](https://docs.evetev.com/cobros.md): Campos de POST /v1/pagos, idempotencia, el dominio del retorno y los estados.
- [Recibir el aviso](https://docs.evetev.com/webhooks.md): Verificar la firma HMAC, reintentos, y qué hacer si el aviso no llega.
- [Integrar con una IA](https://docs.evetev.com/ia.md): Qué darle a un asistente para que escriba la integración sin inventar.

## Referencia

- [Endpoints](https://docs.evetev.com/referencia.md): Todos los endpoints que alcanza la llave de un comercio.
- [Errores](https://docs.evetev.com/errores.md): Qué significa cada código que no es 2xx y qué hacer con él.

## Para máquinas

- [Toda la documentación](https://docs.evetev.com/llms-full.txt): las 7 páginas en un archivo.
- [OpenAPI](https://docs.evetev.com/openapi.json): la especificación de la API.