Endpoints
Base: https://api.evetev.com/v1 · Autenticación: Authorization: Bearer evpk_…
Para cobrar en una tienda solo necesitas los dos primeros de «Cobros» y los de «Avisos». El resto es para construir tu propio panel si lo quieres.
Cobros
| Endpoint | Qué hace |
|---|---|
POST /v1/pagos |
Crea un cobro. Exige el header Idempotency-Key. |
GET /v1/pagos |
Tus cobros, paginados. |
GET /v1/pagos/:id |
Un cobro y su estado. |
GET /v1/pagos/:id/liquidacion |
Cuánto te queda de ese cobro y cuándo. |
GET /v1/pagos/stats |
Totales por estado y periodo. |
GET /v1/pagos/bancos |
Bancos de PSE, para tu propio formulario. |
Tu comercio
| Endpoint | Qué hace |
|---|---|
GET /v1/merchants/me |
Tus datos. De aquí sale el merchantId. |
GET /v1/merchants/me/registro-web |
Tu sitio y tu página de retorno. |
PUT /v1/merchants/me/registro-web |
Los cambia. Queda registrado quién y cuándo. |
Avisos
| Endpoint | Qué hace |
|---|---|
POST /v1/webhook-endpoint |
Registra tu endpoint. Devuelve el secreto una sola vez. |
GET /v1/webhook-endpoint |
El endpoint registrado. |
PUT /v1/webhook-endpoint |
Cambia la URL o lo desactiva. |
Personas
| Endpoint | Qué hace |
|---|---|
GET /v1/personas |
Quién tiene acceso a tu portal. |
POST /v1/personas |
Invita a alguien. |
PATCH /v1/personas/:id |
Le cambia el rol. |
DELETE /v1/personas/:id |
Le quita el acceso. |
Roles
Una persona invitada como solo lectura puede consultar todo lo anterior pero no crear cobros, ni cambiar tu sitio, ni tocar el webhook. Es el permiso del contador.
Esta lista cubre lo que un comercio puede usar. Hay más endpoints en la API, pero son de la operación interna de EvePay y tu llave no los alcanza.
También publicamos la especificación en OpenAPI.