Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.zopay.cash/llms.txt

Use this file to discover all available pages before exploring further.

En operaciones que crean o modifican recursos financieros (por ejemplo POST /connect/v1/payouts y POST /connect/v1/payouts/quote), debes enviar el header Idempotency-Key con un identificador único generado por tu sistema. Si la red falla y reintentas la misma petición con la misma clave y el mismo cuerpo, Zopay no ejecutará la operación dos veces: devolverá el resultado de la primera ejecución exitosa.

​
Recomendación

Usa un UUID v4 por cada intento de operación nueva (no reutilices UUIDs entre operaciones distintas). 
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
El valor anterior es solo un ejemplo de formato, no una clave asignada por Zopay.

​
Ejemplo (ejecutar payout)

Tras obtener un quote_id de POST /payouts/quote, la ejecución envía solo ese id: 
curl -X POST "https://api.zopay.cash/connect/v1/payouts" \
  -H "Authorization: Bearer sk_live_xxxxxxxx" \
  -H "Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -d '{"quote_id": "qt_pay_..."}'
Guía paso a paso en Primer payout.

​
Reglas importantes

  • Mismo cuerpo: Si reutilizas la clave pero cambias campos relevantes del JSON, la petición se rechaza (idempotency_conflict).
  • Caducidad: Las claves expiran tras un periodo limitado (habitualmente 24 horas). Pasado ese tiempo no podrás reintentar con la misma clave una operación antigua.