Создание платежа
Создание платежа
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 сертификат на оплаты», сохраните архив, распакуйте
- password.txt
- private.pem
- public.pem
Мы сохраняем у себя только 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_rub_hpp',
]);
var_dump($payment);