API INTEGRATION INFORMATION
RO | EN
Cardapp Cloud API is a flexible interface compatible with the most commonly used programming languages. This API interface allows the integration of the Cardapp Cloud platform with other online applications.

All communications with the Cardapp Cloud API are encrypted using the HTTPS or SSL protocol. Any unsecured call (HTTP only) is automatically rejected.

Features accessible through API methods

Checking card types;
Issuing new loyalty cards;
Adding bonus points and recording payments;
Refund/ cancel an order;
Using / querying / spending points from the card;
Checking the number of points accumulated on the card;
API CONNECTION DETAILS
Username
emailul_dvs@Domeniu_Dvs.ro

API KEY
TEST-123121313132fsdfdsfdsf4546464645

Access link for querying the Cardapp platform via cURL POST / GET
https://Subdomeniu.Domeniu_Dvs.ro/api/response.php

Queries can be performed using CURLOPT_POST (recommended) or GET.

WARNING! Make sure to enter your API credentials correctly. Otherwise, access to the API application will be automatically blocked after 3 consecutive failed queries!
CREATE / GENERATE LOYALTY CARD

Example of a GET request:

https://Subdomeniu.Domeniu_Dvs.ro/api/response.php?apikey=TEST-123121313132fsdfdsfdsf4546464645&username=emailul_dvs@Domeniu_Dvs.ro&action=creare&telefon={TELEFON_CLIENT}&email={EMAIL_CLIENT}&prenume={PRENUME_CLIENT}&nume={NUME_CLIENT}&data_nastere={DATA_NASTERE_CLIENT}&localitate={LOCALITATE}&referrer={REFERRER}&card_type_id={CARD TYPE ID}&store_id={STORE ID}&send_card={FARA, EMAIL sau SMS}&tip_response={json sau xml}

Do not use { }. They are only for highlighting purposes. Correct: key=value Wrong: key={value}

Required parameters

Name Mandatory field Description
apikey YES API Key
username YES Email address used to connect to Cardapp
action YES Enter creare
telefon YES Your client's phone number (valid, 10 digits, format 07xxxxxxxx - RECOMMENDED).
You can also enter another type of international number, but the SMS will NOT be sent. If the client does not have/ not provide a phone number, enter 0
email NO Your client's email address (if not available, it will be generated automatically; this field can be left blank)
nume NO Your client's name (this field can be left blank)
prenume NO Your client's last name (this field can be left blank)
data_nastere NO Your client's date of birth - Format yyyy-mm-dd (this field can be left blank)
localitate NO Client's locality (this field can be left blank)
referrer NO Referring client (this field can be left blank)
card_type_id NO Unique card type ID (this field can be left blank for DEFAULT type)
store_id NO Unique locations / work point ID (this field can be left blank)
send_card NO Possible options:
SMS - the Cardapp system will send the client’s card via SMS;
EMAIL - the system will send the client’s card via EMAIL;
NONE or left blank - the client’s card will NOT be sent.
tip_response NO Enter xml if you want the response in XML format or json for JSON format
{
"status":"success",
"prenume":"PRENUME_CLIENT",
"nr_card":"TEST_0000005889",
"uniqueid":"ds4a645sda5dsa6d5465das4das54d6448789ddfggghfbnnnqw"

}
<creare_card_response>

<status>success</status>
<prenume>ION</prenume>
<nr_card>FIA_123456789</nr_card>
<uniqueid>ds4a645sda5dsa6d5465das4das54d6448789ddfggghfbnnnqw</nr_card>

</creare_card_response>


RESPONSE PARAMETERS DETAILS

- prenume - Client's last name
- nr_card - The card number generated by the system
- uniqueid - The unique ID of the customer (optional)