Definiciones Base
URL Base
| Ambiente | URL |
|---|---|
| Pruebas (nacional) | https://test.metrepay.com/api/ |
| Producción (nacional) | https://portal.metrepay.com/api/ |
| Pruebas (internacional) | https://intl-test.metrepay.com/api/ |
| Producción (internacional) | https://internacional.metrepay.com/api/ |
Los accesos al ambiente de pruebas se pueden solicitar por correo a info@metrepay.com, o directamente con la persona que le acompañó en su proceso de alta a MetrePay.
Autenticación
Todas las peticiones a la API deben incluir el header Api-Token con un token en formato UUID.
| Header | Valor |
|---|---|
Api-Token |
UUID proporcionado por MetrePay |
Ejemplo del formato: 378f1be7-daeb-4d75-a6d6-a4bcc431225e
El token es de uso único y no se renueva periódicamente. Se puede solicitar por correo a info@metrepay.com.
Códigos de Estado de Links de Pago
| Código | Significado |
|---|---|
| 20 | Cancelado |
| 100 | Pendiente / Solicitado |
| 200 | Pagado |
Flujo para Implementaciones de E-commerce
Para los comercios que deseen realizar implementaciones de e-commerce, se deben considerar los siguientes aspectos:
- MetrePay utiliza autenticación de clientes vía Google/Facebook, por lo que el link de pago no puede ser embebido dentro de un dominio externo por validaciones de seguridad.
- El link de pago debe abrirse en una nueva ventana/pestaña.
- Se puede configurar una URL de redirección para regresar al sitio del comercio tras completar el flujo de pago.
Flujo de Pasos
- El comercio genera el link de pago vía API (incluyendo el parámetro
redirectUrl). - Se abre el link de pago de MetrePay en una nueva ventana.
- El cliente realiza el login y completa el proceso de pago.
- MetrePay notifica al comercio (vía webhook) que el pago fue exitoso.
- El comercio responde con un "OK".
- MetrePay redirige al cliente a la URL indicada en el paso 1.