Vendes externes

POST/api/v1/sales

Registrar una venda cobrada fora

Si cobres fora de Clonify (la teva passarel·la, Hotmart, ThriveCart…), registra aquí cada venda i el programa d'afiliats funciona igual que si el cobrament fos nostre: la venda s'atribueix per l'email del comprador (el lead mana) o pel codi ref de l'afiliat si ha viatjat fins al teu checkout, i la comissió es calcula amb el teu % i els teus terminis. L'afiliat la veu al seu portal a l'instant. Idempotent per order_ref: reenviar la mateixa venda respon already_recorded i no duplica res — pots reintentar sense por. Pensat per disparar-se des de n8n, Make o Zapier quan es tanca una venda.

Permís d'escripturaPlans Pro i Scale (Afiliats)

Cos (JSON)

emailstring (email)obligatori

Email del comprador. És el que uneix la venda amb el seu lead — i amb l'afiliat que el va portar.

amount_centsintegerobligatori

Import cobrat, en cèntims (1.997 € → 199700).

order_refstring 1..120obligatori

El nº de comanda al teu sistema: la identitat de la venda. Reenviar-lo no duplica, i la devolució es registra contra ell.

product_idintegerobligatori

La fitxa de Clonify del producte venut (GET /api/v1/products per als ids). Si vens fora, val la fitxa d'enllaç extern.

refstring

Codi d'afiliat (?ref=) arrossegat fins al teu checkout, si en tens. És l'assegurança per si el comprador paga amb un altre email.

currencystring ISO-3

Avui només EUR ("eur" o omès). Amb una altra moneda la porta retorna 400: converteix a cèntims d’euro abans d’enviar.

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ó

Reflecteix la devolució d'una venda registrada per l'API. La comissió de l'afiliat baixa sola (sempre es calcula neta de devolucions); la venda no s'esborra, queda marcada perquè tot quadri amb la teva passarel·la.

Permís d'escripturaPlans Pro i Scale (Afiliats)

Cos (JSON)

order_refstring 1..120obligatori

El mateix nº de comanda amb què vas registrar la venda.

refunded_amount_centsintegerobligatori

L’ACUMULAT retornat d’aquesta venda, en cèntims — no el delta. Enviar dues vegades el mateix ho deixa igual, i l’acumulat NOMÉS POT CRÉIXER: una devolució registrada no es pot desfer, així que verifica l’order_ref abans d’enviar. Devolució total = l’import sencer.

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
}

Vendes externes

POST/api/v1/sales

Registrar una venda cobrada fora

Permís d'escripturaPlans Pro i Scale (Afiliats)

Cos (JSON)

emailstring (email)obligatori

Email del comprador. És el que uneix la venda amb el seu lead — i amb l'afiliat que el va portar.

amount_centsintegerobligatori

Import cobrat, en cèntims (1.997 € → 199700).

order_refstring 1..120obligatori

El nº de comanda al teu sistema: la identitat de la venda. Reenviar-lo no duplica, i la devolució es registra contra ell.

product_idintegerobligatori

La fitxa de Clonify del producte venut (GET /api/v1/products per als ids). Si vens fora, val la fitxa d'enllaç extern.

refstring

Codi d'afiliat (?ref=) arrossegat fins al teu checkout, si en tens. És l'assegurança per si el comprador paga amb un altre email.

currencystring ISO-3

Avui només EUR ("eur" o omès). Amb una altra moneda la porta retorna 400: converteix a cèntims d’euro abans d’enviar.

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ó

Permís d'escripturaPlans Pro i Scale (Afiliats)

Cos (JSON)

order_refstring 1..120obligatori

El mateix nº de comanda amb què vas registrar la venda.

refunded_amount_centsintegerobligatori

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
}