Crear un backend alojado
Un backend alojado es un backend que corremos por ti. Sirve los proveedores que eliges y responde en una dirección propia, así que tu integración lo llama igual que llama al proveedor. Esta página va desde crearlo hasta tener una dirección a la que puedes llamar.
Para correr un backend en tu propia red, consulta la sección de self-hosted.
Consulta Resumen de backends self-hosted.
El video crea un backend alojado para Stripe y PayPal y agrega una regla que rechaza $66.60 como fraude. Después lo despliega y apunta una tienda pequeña hacia él. En la tienda solo cambia la dirección de la API.
Antes de empezar
Necesitas un proveedor del tipo que quieres correr. El backend solo puede servir marcas que tu organización tiene.
Consulta Agregar proveedores.
Tu plan tiene que permitir un backend, y la Tienda de backends te avisa cuando no lo permite. Además, cada backend cuenta como una simulación dentro del límite de tu plan.
Cualquiera con el rol de editor o superior puede crearlo. Solo la compra de proveedores queda reservada a los owners.
Crearlo
Abre la Tienda de backends, busca el tipo en Tipos y usa Nuevo backend ahí. También puedes abrir Simulaciones, usar la flecha junto a Nueva simulación y elegir Backend.
El diálogo tiene tres campos:
- Tipo: pagos o identidad. Solo aparecen los tipos de los que tienes un proveedor, y el tipo no se puede cambiar después.
- Nombre: es para ti, y es lo que muestran las listas. Cámbialo cuando quieras.
- Nombre de host: la primera parte de la dirección del backend, como
shop-paymentsenshop-payments.pay.mockz.io. Sigue al nombre mientras escribes, hasta que lo editas.
Un nombre de host tiene de 3 a 63 caracteres: letras minúsculas, dígitos y guiones sueltos. No puedes usar palabras que reservamos, como api o admin, ni el nombre de un proveedor, como adyen o stripe, ni un nombre de host que ya usa otra organización. Puedes cambiarlo hasta el primer despliegue. Después queda fijo.
Crear un backend no despliega nada. Se abre en Proveedores, todavía sin nada seleccionado.
Elegir qué sirve
Proveedores lista cada marca de este tipo que tu organización tiene. Selecciona lo que sirve este backend. El cambio se guarda solo.
Elige en el nivel que te sirva:
- La marca, como Adyen, que cubre cada API y cada versión que tiene debajo.
- Una API de esa marca, como checkout.
- Una versión exacta, como v71.
Seleccionar una marca cubre las filas de debajo, y esas filas lo indican. Seleccionar todo toma cada marca que tienes. Una fila marcada No está en este build es algo que el build del backend no incluye, y no se puede elegir.
Imagen base, arriba a la derecha, es el build que corre el backend. Por defecto es el build más reciente.
Consulta Fijar una versión de build.
Es normal correr más de un backend con selecciones distintas. Un backend que sirve una sola marca manda cada solicitud a ese proveedor y a ningún otro. Eso es lo que necesita una prueba sobre una sola integración.
Desplegarlo
Usa Desplegar en el encabezado. El estado pasa de Fuera de línea a Desplegando y luego a Activa. La dirección aparece debajo del nombre, con botones para copiarla o abrirla. El primer despliegue tarda más que los siguientes.
Lo que cambies después, como los proveedores, la configuración o los escenarios, se guarda al momento y llega al backend en su próximo despliegue.
Si se rechaza un despliegue, la página dice por qué. La razón más común es un backend sin ningún proveedor seleccionado.
Dónde responde
Un backend alojado responde en su propio host:
- Pagos:
https://<hostname>.pay.mockz.io - Identidad:
https://<hostname>.kyx.mockz.io
Cada versión de un proveedor responde bajo su propia ruta en ese host, como /adyen/checkout/v71. Todo lo que va después de esa ruta es la ruta propia del proveedor, así que una solicitud de pago es:
POST https://shop-payments.pay.mockz.io/adyen/checkout/v71/paymentsEl SDK de un proveedor manda sus solicitudes a la raíz (/) de un host. Para usarlo, pon la versión que corresponde en la raíz: abre Configuración del servicio, elige la versión, borra su ruta y pulsa Enter. Entonces también responde en https://shop-payments.pay.mockz.io/payments, y sigue respondiendo en su propia ruta.
Para poner el backend en otro de nuestros dominios, elígelo en Host, dentro de Despliegue, y guarda antes del primer despliegue. El host y el nombre de host quedan fijos desde el primer despliegue.
Configuración que conviene conocer
General tiene el nombre, el icono y Comportamiento, que controla lo que hace el backend además de responder:
- Explorador de API: una interfaz navegable en la dirección del backend. Si lo apagas, solo responde la API.
- Registrar tráfico: guarda cada solicitud y cada respuesta, y eso es lo que llena el Historial. Está apagado hasta que lo enciendes. Guardar por es cuánto tiempo se quedan, hasta lo que permite tu plan.
- Replay: graba una respuesta una vez y responde con ella a las solicitudes que coinciden. Tiene su propio Guardar por: cuánto tiempo se guarda una grabación, 24 horas si no lo cambias.
Acceso decide quién puede llegar al backend, con una API key, una contraseña para el explorador o una lista de IPs permitidas. Funciona igual que en cualquier simulación.
Consulta Control de acceso.
Ponerlo fuera de línea
Un backend que no estás usando se puede apagar. Usa la flecha junto a Desplegar y elige Poner fuera de línea. La dirección deja de responder, y todo lo que configuraste se queda. Desplegar lo trae de vuelta.
Borrar un backend, en General, lo elimina para siempre. Si alguna vez se desplegó, su nombre de host queda con tu organización durante 90 días, para que nadie más lo tome mientras tanto.
Cuando ya responde
El backend guarda un registro de lo que ha hecho, como los pagos que recibió, y su barra lateral los lista.
Consulta Actividad del backend.