POST https://kvitka.org/api/points/new.php
This endpoint creates a new non-personalized digital card within the Kvitka service. No request body or authentication tokens are required. Once called, it generates a unique digital card code and provides a direct link to access it. The created card is active immediately.
POST
Content-Type: application/jsonNo request payload required. The creation process is automatic upon calling the endpoint.
The response is returned as a JSON object.
message (string): A confirmation message, e.g. "A new digital card has been successfully created!"card_code (string): A unique 16-digit code for the newly created card.card_link (string): A URL that leads directly to the newly created card page.Below is a minimal example that sends a POST request to the endpoint and prints out the response:
<?php
// Set the endpoint URL
$url = 'https://kvitka.org/api/points/new.php';
// Create a POST request with JSON headers
$options = array(
'http' => array(
'header' => "Content-type: application/json\r\n",
'method' => 'POST'
)
);
// Create a context resource for the request
$context = stream_context_create($options);
// Send the request and store the response
$response = file_get_contents($url, false, $context);
// Print the response
echo $response;
?>
{
"message": "A new digital card has been successfully created!",
"card_code": "9999999999999999",
"card_link": "https://kvitka.org/card.php?c=9999999999999999"
}
POST https://kvitka.org/api/points/create.php
This endpoint allows you to add points to an existing digital card associated with a user. You must provide a valid key_holder, the user's login_user (unique card code), the login_holder (client login), and the number of points to be added. The number of points cannot exceed 500 per request.
If successful, the endpoint will return a confirmation message and the updated points.
POST
Content-Type: application/jsonA JSON object with the following fields:
key_holder (string): The valid access key for the card holder.login_user (string): The unique card code (digital card user login).login_holder (string): The client's login identifier.points_user (integer): The number of points to add (must be ≤ 500).For example:
{
"key_holder": "fdpfffffGOZK7BX",
"login_user": "9999999999999999",
"login_holder": "wwwwwuNrYr9Z",
"points_user": "100"
}
JSON object with a message and points details.
message (string): "Points successfully accrued!" or an error message.card_code (string): The card's unique identifier (login_user).points (integer): The number of points that have been added.Below is a minimal example that sends a POST request to the endpoint with appropriate data:
<?php
// Set the endpoint URL
$url = 'https://kvitka.org/api/points/create.php';
// Set the access key and other data
$data = array(
'key_holder' => 'fdpfffffGOZK7BX',
'login_user' => '9999999999999999',
'login_holder' => 'wwwwwuNrYr9Z',
'points_user' => '100'
);
// Create a POST request with JSON headers and encoded data
$options = array(
'http' => array(
'header' => "Content-type: application/json\r\n",
'method' => 'POST',
'content' => json_encode($data)
)
);
// Create a context resource for the request
$context = stream_context_create($options);
// Send the request and store the response
$response = file_get_contents($url, false, $context);
// Print the response
echo $response;
?>
{
"message": "Points successfully accrued!",
"card_code": "9999999999999999",
"points": "100"
}
POST https://kvitka.org/api/points/update.php
This endpoint allows you to exchange accumulated points on a digital card for a discount on a purchase. You provide the partner key (key_partner), the user's card code (login_user), the client's login (login_client), the total purchase amount (sum_exchange), the discount percentage (percentages_discount), and the currency (currency_name).
If successful, the endpoint returns a message confirming the exchange, the card code, the discounted amount, Kvitka's service fee, and the currency type.
POST
Content-Type: application/jsonA JSON object containing the following fields:
key_partner (string): Valid partner key provided by Kvitka.login_user (string): The unique card code of the user.login_client (string): The login identifier of the client making the request.sum_exchange (number): The total purchase amount.percentages_discount (number): The discount percentage to be applied to the purchase.currency_name (string): The currency type, one of UAH, USD, EUR, SEK, PLN.Example request body:
{
"key_partner": "FgtyrBVh8P6LNcQ",
"login_user": "1234567890123456",
"login_client": "AbCdEfGh12345",
"sum_exchange": "300",
"percentages_discount": "10",
"currency_name": "UAH"
}
The response is returned as a JSON object.
message (string): Confirmation message, e.g. "Points have been successfully exchanged!"card_code (string): The user's card code.discount_amount (number): The total original purchase amount (before discount), for clarity.kvitka_fee (number): The service fee charged by Kvitka, calculated as a portion of the total amount.currency_type (string): The currency code used in the transaction.Below is a minimal example that sends a POST request to the endpoint using fictional data:
<?php
// Set the endpoint URL
$url = 'https://kvitka.org/api/points/update.php';
// Set the access key and other data
$data = array(
'key_partner' => 'FgtyrBVh8P6LNcQ',
'login_user' => '1234567890123456',
'login_client' => 'AbCdEfGh12345',
'sum_exchange' => '300',
'percentages_discount' => '10',
'currency_name' => 'UAH'
);
// Create a POST request with JSON headers and encoded data
$options = array(
'http' => array(
'header' => "Content-type: application/json\r\n",
'method' => 'POST',
'content' => json_encode($data)
)
);
// Create a context resource for the request
$context = stream_context_create($options);
// Send the request and store the response
$response = file_get_contents($url, false, $context);
// Print the response
echo $response;
?>
{
"message": "Points have been successfully exchanged!",
"card_code": "1234567890123456",
"discount_amount": "300",
"kvitka_fee": "3",
"currency_type": "UAH"
}