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!
ADAUGARE PUNCTE PE CARD / INREGISTRARE PLATA

Exemplu de request GET:

https://Subdomeniu.Domeniu_Dvs.ro/api/response.php?apikey=TEST-123121313132fsdfdsfdsf4546464645&username=emailul_dvs@Domeniu_Dvs.ro&action=adaugare_puncte&nr_card={NUMARUL CARDULUI}&suma={SUMA_VANZARE}&detalii_incasare={DETALII PLATA, 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 adaugare_puncte
nr_card DA Se introduce numarul de card al clientului
suma DA Se introduce valoarea in LEI a vanzarii, Ex: 500
In cazul in care este o comanda anulata sau returnata introduceti valoarea negativa Ex: -500
detalii_incasare 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_acumulate":74,
"detalii_incasare":"BF AA Nr.123456 / 04.10.2022",
"valoare_totala_puncte_lei":137

}
<adaugare_puncte_response>

<status>success</status>
<nr_card>CBW_6332c9b22f01b</nr_card>
<suma>750</suma>
<puncte_acumulate>40</puncte_utilizate>
<detalii_incasare>BF AA Nr.123456 / 04.10.2022</detalii_incasare>
<valoare_totala_puncte_lei>5.6</valoare_totala_puncte_lei>

</adaugare_puncte_response>