Создание выплаты

Создание выплаты

URL POST
https://api-merchant.alikassa.com/v1/payout
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". Пример кода найдете в конце документа.

* - Обязательные поля
* - При создании выплаты на счёт по валюте EUR - обязателен
Название Тип Описание Пример
amount* string Сумма "1000.44"
number* string Номер счета, карты
order_id* string (128) Ваш id (должен быть уникальный)
service* string (100) Сервис (Счет, Способы приема) payment_card_rub
notification_endpoint_id int Id уведомления
notification_endpoint_url string|max:255 Ссылка для отправки колбека после финализации статусов
extra* array Принимает в себя необязательные параметры для повышении конверсии
[
   "card_exp_year" => "24",
   "card_exp_month" => "01",
   "card_holder" => "CARDHOLDER NAME",
   "card_country" => "UA",
   "card_recipient_birth_date" => "1999-12-15",
]
extra["card_exp_year"]* string (2) Срок действия банковской карты (год) "24"
extra["card_exp_month"]* string (2) Срок действия банковской карты (месяц) "01"
extra["card_holder"]* string (100) Имя владельца карты "CARDHOLDER NAME"
extra["card_country"]* string (2) Alpha-2 ISO 3166-1 Страна банковской карты "UA"
extra["card_recipient_birth_date"]* string Дата рождения держателя карты "1999-12-15"
customer_phone string Телефон клиента "79001112233"
customer_email string|email Email клиента "[email protected]"

Ответ

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

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

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

{
   "payment_status": "wait",
   "id": 100001524
}

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

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

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

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

Пример

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

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

    $privateKey = openssl_pkey_get_private(
        file_get_contents(__DIR__ . '/cert/payout/private.pem'),
        file_get_contents(__DIR__ . '/cert/payout/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);
}


$payout = requestPayout('v1/payout', '93d5df06-996c-48c3-9847-348d6b580b80', [
    'order_id' => (string)time(),
    'amount' => 500,
    'number' => '79005554455',
    'notification_endpoint_id' => 5,
    'service' => 'qiwi_rub',
]);

var_dump($payout);