INFORMATII INTEGRARI API
RO | EN
Cardapp Cloud API este o interfata flexibila, compatibila cu cele mai des intalnite limbaje de programare. Aceasta interfata API permite integrarea platformei Cardapp Cloud cu alte aplicatii online.

Toate comunicatiile Cardapp Cloud API sunt criptate prin utilizarea protocolului HTTPS sau via SSL. Orice apelare nesecurizata este respinsa (nu este permis doar HTTP) in mod automat.

Facilitatile care pot fi accesate prin metodele API

Interogare tipuri de card;
Emiterea de noi carduri de fidelitate;
Adaugarea de puncte bonus si inregistrare plati;
Anularea sau returul unei comenzi;
Utilizare/ interogare/ cheltuire puncte de pe card;
Interogare numar de puncte acumulate pe card;
DATE DE CONECTARE API
Username
emailul_dvs@Domeniu_Dvs.ro

Parola API
TEST-123121313132fsdfdsfdsf4546464645

Link acces interogare platforma Cardapp cURL POST / GET
https://Subdomeniu.Domeniu_Dvs.ro/api/response.php

Interogarile se pot efectua folosind CURLOPT_POST (recomandat) sau GET.

ATENTIE! Introduceti corect datele dvs. API, in caz contrar, se va bloca automat accesul la aplicatia API dupa 3 interogari consecutive gresite!
RETURNARE PUNCTE PE CARD (anulare/ retur comanda la care s-au utilizat puncte)

Exemplu de request GET:

https://Subdomeniu.Domeniu_Dvs.ro/api/response.php?apikey=TEST-123121313132fsdfdsfdsf4546464645&username=emailul_dvs@Domeniu_Dvs.ro&action=refund_points&nr_card={NUMARUL CARDULUI}&points_amount={NUMAR_PUNCTE}&refund_amount={-VALOAREA_COMENZII_ANULATE}&details_refund=DETALII PLATA RETUR, BF, FACTURA SERIE NR ETC.}&tip_response={json sau xml}

Nu folositi { }. Sunt doar pentru evidentiere. Corect: key=value Gresit: key={value}

Parametrii necesari

Nume Camp
obligatoriu
Descriere
apikey DA Parola API
username DA Adresa de Email cu care va conectati la Cardapp
action DA Se introduce refund_points
nr_card DA Se introduce numarul de card al clientului
points_amount DA Se introduc numarul de puncte utilizate la comanda initiala (valoare pozitiva, NO + sign)
refund_amount DA Se introduce valoarea comenzii anulate (valoare negativa SE ADAUGA SEMNUL -)
details_refund DA Se adauga detaliile platii BON FISCAL, FACTURA, OBSERVATII, UNIQUE ORDER ID sau altceva.
tip_response NU Se introduce xml in cazul in care doriti raspunsul in format XML sau json pentru format JSON
{
"status":"success",
"nr_card":"CBW_6332c9b22f01b",
"suma":"740",
"puncte_utilizate":37,
"detalii_incasare":"BF AA Nr.123456 / 04.10.2022",
"valoare_totala_puncte_lei":137

}
<cheltuire_puncte_response>

<status>success</status>
<nr_card>CBW_6332c9b22f01b</nr_card>
<suma>750</suma>
<puncte_utilizate>37</puncte_utilizate>
<detalii_incasare>BF BB Nr.123456 / 04.10.2022</detalii_incasare>
<valoare_totala_puncte_lei>5.6</valoare_totala_puncte_lei>

</cheltuire_puncte_response>