ClonifyDevelopersIr al panel

Empezar

  • Autenticación
  • Errores
  • Paginación
  • Límites de peticiones
  • Webhooks
  • Para agentes de IA
  • Servidor MCP

Referencia de la API

  • Seguimiento de alumnos6
  • Entregas externas por API6
  • Chat con el clon1
  • Contactos y etiquetas5
  • Accesos de academias4
  • Conversaciones4
  • Catálogo de productos11
  • Ventas externas2
  • Conocimiento12
  • Multimedia4
  • Clones (versions en la API)3
  • Reuniones y reservas3
  • Webinars6
  • Cuenta y consumo1
Clonify

Ventas externas

POST/api/v1/sales

Registrar una venta cobrada fuera

Si cobras fuera de Clonify (tu pasarela, Hotmart, ThriveCart…), registra aquí cada venta y el programa de afiliados funciona igual que si el cobro fuera nuestro: la venta se atribuye por el email del comprador (el lead manda) o por el código ref del afiliado si viajó hasta tu checkout, y la comisión se calcula con tu % y tus plazos. El afiliado la ve en su portal al momento. Idempotente por order_ref: reenviar la misma venta responde already_recorded y no duplica nada — puedes reintentar sin miedo. Pensado para dispararse desde n8n, Make o Zapier al cerrarse una venta.

Permiso de escrituraPlanes Pro y Scale (Afiliados)

Cuerpo (JSON)

emailstring (email)obligatorio

Email del comprador. Es lo que une la venta con su lead — y con el afiliado que lo trajo.

amount_centsintegerobligatorio

Importe cobrado, en céntimos (1.997 € → 199700).

order_refstring 1..120obligatorio

El nº de pedido en tu sistema: la identidad de la venta. Reenviarlo no duplica, y la devolución se registra contra él.

product_idintegerobligatorio

La ficha de Clonify del producto vendido (GET /api/v1/products para los ids). Si vendes fuera, vale la ficha de enlace externo.

refstring

Código de afiliado (?ref=) arrastrado hasta tu checkout, si lo tienes. Es el seguro por si el comprador paga con otro email.

currencystring ISO-3

Hoy solo EUR ("eur" u omitido). Con otra moneda la puerta devuelve 400: convierte a céntimos de euro antes de mandar.

namestring
bash
curl -X POST "https://www.clonify.com/api/v1/sales" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"email":"…","amount_cents":1,"order_ref":"…","product_id":1}'
json
{
  "object": "sale",
  "order_ref": "PED-1042",
  "product_id": 12,
  "product_title": "Máster Ejecutivo",
  "amount_cents": 199700,
  "already_recorded": false,
  "affiliate": { "name": "Ana Ruiz", "code": "a7fk29" }
}
POST/api/v1/sales/refund

Registrar una devolución

Refleja la devolución de una venta registrada por la API. La comisión del afiliado baja sola (siempre se calcula neta de devoluciones); la venta no se borra, queda marcada para que todo cuadre con tu pasarela.

Permiso de escrituraPlanes Pro y Scale (Afiliados)

Cuerpo (JSON)

order_refstring 1..120obligatorio

El mismo nº de pedido con el que registraste la venta.

refunded_amount_centsintegerobligatorio

El ACUMULADO devuelto de esa venta, en céntimos — no el delta. Mandar dos veces lo mismo deja lo mismo, y el acumulado SOLO PUEDE CRECER: una devolución registrada no se puede deshacer, así que verifica el order_ref antes de mandar. Devolución total = el importe entero.

bash
curl -X POST "https://www.clonify.com/api/v1/sales/refund" \
  -H "Authorization: Bearer clk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"order_ref":"…","refunded_amount_cents":1}'
json
{
  "object": "refund",
  "order_ref": "PED-1042",
  "refunded_amount_cents": 199700
}