Antes de empezar
Dos cosas que hay que dejar listas en el portal del comercio. Sin ellas la API rechaza los cobros, y es a propósito.
1. Registra tu sitio y a dónde vuelve el comprador
En el portal, en Ajustes → Tu sitio y el regreso del comprador, van dos direcciones:
| Dato | Qué es |
|---|---|
| Tu sitio web | https://tutienda.co. Define el dominio al que puede volver un comprador. |
| Página de retorno | https://tutienda.co/gracias. A dónde vuelve quien paga cuando el cobro no trae una propia. |
Las dos tienen que ser https, y la de retorno tiene que ser de tu propio sitio o de un subdominio suyo. Es lo que impide que, si alguien se roba tu llave, pueda llevarse a tus compradores a la página de otro.
Sin esto no puedes cobrar. No es burocracia: un cobro sin página de retorno deja al comprador en la pasarela, sin forma de volver a tu tienda ni de saber si su pedido quedó hecho. Lo comprobamos pagando de las dos formas en el ambiente de pruebas de la pasarela.
2. Consigue tu llave de integración
En el mismo portal, en Ajustes → Clave de integración. Empieza por evpk_ y se muestra una sola vez: si la pierdes, la rotas y la anterior deja de servir.
La llave es secreta y va solo en tu servidor. Nunca en el navegador, ni en el código de tu página, ni en una app móvil: quien la tenga puede cobrar en tu nombre. Por eso no hay un fragmento de JavaScript para pegar en tu tienda — la integración es de servidor a servidor.
Comprueba que todo responde
Con la llave en la mano, esto te devuelve los datos de tu comercio:
curl https://api.evetev.com/v1/merchants/me \
-H "Authorization: Bearer evpk_tu_llave"
Si responde 401, la llave está mal o la rotaste. Si responde 200, ya puedes crear tu primer cobro.
El id de tu comercio
La respuesta anterior trae un id: ese es el merchantId que lleva cada cobro. Guárdalo en tu configuración; no cambia.