Cupoanele de reducere pot fi de tip import (se încarcă manual coduri) sau API (codurile sunt generate on-demand).
Pentru a genera cupoane de reducere din website via API, este nevoie ca website-ul dumneavoastră să expună un webhook URL care:
- primește mai mulți parametrii GET
- generează coduri unice (cu o singură utilizare) în website-ul dumneavoastră în funcție de parametrii trimiși
Parametrii GET obligatorii ce pot fi specificați sunt următorii:
type – INT – Tipul discount-ului generat de cupon, poate fi 0 (valoare fixă), 1 (procent) sau 2 (livrare gratuită)
value – INT | FLOAT – Apare pentru tip procent sau valoare fixă. Dacă discount_type este percent (1), conține procentajul pentru reducere, altfel conține valoarea fixă.
Opțional, se pot specifica și următorii parametrii:
batch_size – INT – numărul de coduri care ar trebui generate de webhook URL (Opțional, dar recomandat. Codurile pot fi generate în batch-uri pentru a reduce numărul de request-uri. Se poate întoarce un singur cod chiar dacă este prezent acest parametru)
prefix – String – prefix-ul care ar trebui să fie adăugat la începutul codurilor
expire_date – String – data în format YYYY-MM-DD HH:II:SS la care ar trebui să expire codurile
min_amount – FLOAT – valoarea minimă a sumei din coș pentru care se poate aplica cuponul (dacă se trimite ar trebui raportat la suma fără TVA)
currency – STRING – poate fi RON sau EUR (este prezent în cazul în care se trimite valoare fixă pentru discount sau valoare minimă pentru comandă)
Răspunsul returnat poate fi un string (care conține codul generat, dacă s-a generat un singur cod) sau un array (listă de coduri), în format json, care conține urmatoarele chei:
- status – 0 (pt eroare) sau 1 (pt succes)
- codes – array conținând codurile generate (în caz de succes)
- msg – mesajul erorii (în caz de eroare)