Создание платежа

• Создание платежа
• Пример

Создание платежа

URL	POST https://api-merchant.alikassa.com/v1/payment
HEADER
Content-Type	application/json
Account	Ваш uuid счета (вы можете найти в разделе "Счета") https://merchant.alikassa.com/cabinet/resources/project-accounts
Sign	Подпись запроса

По ссылке https://merchant.alikassa.com/cabinet/form/setting-api-certs сгенерируйте «API сертификат на оплаты», сохраните архив, распакуйте

Мы сохраняем у себя только public.pem для проверки подписи.

Оберните все POST данные в json(в том же порядке) и подпишите

$data = json_encode($data);

$privateKey = openssl_pkey_get_private(
        file_get_contents('private.pem'),
        file_get_contents('password.txt')
    );

if ($privateKey===false) {

        throw new \Exception('Error cert.');
}

openssl_sign($data, $sign, $privateKey);
    $sign = base64_encode($sign);

Полученную подпись $sign передайте в заголовке "Sign". Пример кода найдете в конце документа.

* - Обязательные поля

Название	Тип	Описание
amount*	decimal (11.2)	Сумма
order_id*	string (128)	Ваш id (должен быть уникальный)
service*	string (100)	Сервис (Счет, Способы приема)
desc	string (128)	Описание
lifetime	int	Время жизни оплаты в секундах (диапазон 900-3600)
customer_ip*	ip	Ip адрес плательщика
customer_account	string (50)	Идентификатор плательщика в вашей системе
customer_email	string (50)	Email адрес плательщика
customer_first_name	string (50)	Имя плательщика
customer_last_name	string (50)	Фамилия плательщика
customer_address	string (50)	Адрес плательщика
customer_phone	string (12)	Телефон плательщика
customer_post_code	int (12)	Почтовый индекс плательщика
customer_state	string (50)	Штат плательщика
customer_city	string (20)	Город плательщика
customer_browser_user_agent*	string (2000)	User agent плательщика
customer_browser_accept_header	string (2000)	HTTP Accept
customer_browser_color_depth	int	screen.colorDepth
customer_browser_language	string(8)	HTTP Accept-Language
customer_browser_screen_height	int	screen.height
customer_browser_screen_width	int	screen.width
customer_browser_window_height	int	window.innerHeight
customer_browser_window_width	int	window.innerWidth
customer_browser_time_different		(new Date()).getTimezoneOffset()
customer_browser_java_enabled	int	1 — поддерживается JavaScript 0 — не поддерживается
success_redirect_id	int	Id редиректа при успешной оплате
fail_redirect_id	int	Id редиректа при не успешной оплате
notification_endpoint_id	int	Id уведомления
success_redirect_url	string|max:255	Ссылка на редирект после успешной оплаты
fail_redirect_url	string|max:255	Ссылка на редирект после не успешной оплаты
notification_endpoint_url	string|max:255	Ссылка для отправки колбека после финализации статусов

Ответ

Название	Описание
id	Id платежа AliKassa
uuid	Uuid платежа AliKassa
url	Ссылка на оплату
payment_status	Статус платежа wait — в процессе оплаты

При создании всегда платежа payment_status: wait. Проверяйте статус оплаты через API или ждите получение уведомления!

Пример успешного ответа HTTP CODE 200:

{
   "url": "https://pay-merchant.alikassa.com/bd291fe1-5c19-4113-ae62-a2d3c4d01d20",
   "payment_status": "wait",
   "id": 100001524,
   "uuid": "h12a5a34-7e21-3789-bf53-96fe96131601"
}

Пример не успешного ответа HTTP CODE 400:

{
   "message": "The given data was invalid.",
   "errors": {
      ...
   }
}

После получения url, переадресуйте клиента по ссылке.

Возможные значения payment_status смотрите в документации «Статус платежа».

Если вы передали notification_endpoint_id, то вы получите уведомление о смене статуса оплаты

Пример

Скачанный архив распакуйте в папку «путь до скрипта/cert/payment/»

function requestPayment(string $method, string $account, array $data)
{
    $data = json_encode($data);

    $privateKey = openssl_pkey_get_private(
        file_get_contents(__DIR__ . '/cert/payment/private.pem'),
        file_get_contents(__DIR__ . '/cert/payment/password.txt')
    );

    if ($privateKey===false) {

        throw new \Exception('Error cert.');
    }

    openssl_sign($data, $sign, $privateKey);
    $sign = base64_encode($sign);

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://api-merchant.alikassa.com/' . $method);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json',
        'Account: ' . $account,
        'Sign: ' . $sign,
    ]);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch,CURLOPT_USERAGENT, 'AliKassa2.0 API');
    curl_setopt($ch, CURLOPT_TIMEOUT, 30);

    $response = curl_exec($ch);

    return json_decode($response, true);
}


$payment = requestPayment('v1/payment', '93d5df06-996c-48c3-9847-348d6b580b80', [
    'order_id' => (string)time(),
    'amount' => 500,
    'customer_browser_user_agent' => 'Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:84.0) Gecko/20100101 Firefox/84.0',
    'customer_ip' => '18.191.80.10',
    'success_redirect_id' => 1,
    'fail_redirect_id' => 1,
    'notification_endpoint_id' => 5,
    'service' => 'payment_card_uah_hpp',
]);

var_dump($payment);