Desarrolladores
Integración en cuatro pasos
API REST, JSON, peticiones firmadas. La documentación con ejemplos en Node.js es abierta, sin registro.
- Paso 1
Firma la petición
HMAC-SHA256 de la marca de tiempo, el método, la ruta y el hash del cuerpo. La clave vive solo en tu servidor.
X-Shop-Id: shop_… X-Timestamp: 1793400000 X-Signature: hex(HMAC-SHA256(secret_key, timestamp ⏎ METHOD ⏎ path ⏎ sha256(body))) - Paso 2
Crea un pago
Importe en unidades mínimas. Repetir con la misma Idempotency-Key devuelve el mismo pago.
POST /v1/payments Idempotency-Key: 4f1c… { "orderId": "A-1001", "amount": 24990, "currency": "EUR", "returnUrl": "https://shop.example/thanks" } - Paso 3
Envía al cliente a pagar
La página de pago muestra los métodos del país y la moneda, cobra y devuelve al cliente a tu sitio.
→ 201 { "id": "pay_…", "status": "created", "checkoutUrl": "https://pay…/c/…" } - Paso 4
Recibe el webhook
Verifica la firma y marca el pedido como pagado. Sin respuesta 2xx, reintentamos durante dos días.
POST https://shop.example/payos/webhook X-Payos-Signature: v1=… { "type": "payment.succeeded", "data": { "orderId": "A-1001", … } }
Empieza a aceptar pagos
Regístrate y verifica tu empresa en el panel. Emitimos las claves API en cuanto se aprueba tu tienda.