Página de pago alojada

Cada factura y depósito tiene una página de pago ya preparada. Envía al cliente el payment_url que devuelve la API en cuanto la dirección esté disponible.

La página muestra el token, la red, la dirección, el código QR y el estado del pago. No necesitas construir tu propia página de pago.

Envía el enlace de pago

Usa payment_url tal como se devuelve. No construyas una URL a partir del ID de la operación ni asumas un formato fijo para public_id.

El cliente debe enviar el token mostrado en la red mostrada. Enviar un token distinto o usar una red distinta no paga la factura.

Configura el nombre y el logo de la tienda

Edita la identidad visual en el panel o usa una sesión de propietario:

PATCH /api/v1/shops/{shop_id}/branding
Authorization: Bearer <owner-session-token>
Idempotency-Key: <saved-unique-key>
Content-Type: application/json

{"name":"My shop"}

La identidad visual controla el nombre y el logo mostrados de la tienda. Define el return_url de un pago al crear la factura o el depósito. Ninguno de los dos cambia el destinatario del pago.

Confirma el pago en tu servidor

El enlace de retorno es solo para navegación. Que el cliente lo abra no es prueba de pago.

Usa Estado de facturas y depósitos para consultar el estado desde tu backend, o verifica un webhook firmado. Mantén las claves de API en el servidor; nunca las pongas en el enlace de pago ni en código de navegador.