Autentica solicitudes del backend

La API para comercios usa una llave Bearer. El gateway deriva el comercio, ambiente, actor y scopes desde esa credencial.

Envía la llave

Incluye la llave en el header Authorization:

Authorization: Bearer your_simplepay_api_key_here

Guárdala en un secret manager. Nunca la incluyas en URLs, metadata, logs, screenshots o código cliente.

Crea una llave por servicio y asigna sólo los scopes necesarios:

Tarea	Scopes principales
Crear y leer Checkout	`hosted_checkout:write`, `hosted_checkout:read`
Crear y leer links	`payment_links:write`, `payment_links:read`
Leer pagos	`reporting:read`
Administrar catálogo	`digital_catalog:write`, `digital_catalog:read`
Administrar webhooks	`webhooks:write`, `webhooks:read`

La referencia muestra x-simplepay-required-scopes en cada operación.

Una llave no puede crear, rotar ni revocar otras llaves. Estas acciones requieren una sesión Customer, rol administrativo y step-up reciente.

El valor completo de una llave nueva se entrega una vez. SimplePay conserva una referencia ofuscada, no el secreto recuperable.

Última modificación el 22 de agosto de 2026