A2C виплата на картку по CARD_TOKEN

Зміст

1 Зміст
2 Опис
3 Чекліст інтеграції
4 API параметри
5 Приклад запиту
6 Тестування
7 Перевірка транзакції
8 Callback & Responce
9 Помилки при виплаті
10 Помилки запитів

Опис

Цей метод використовується для виплати на картку по токену.

В запитів використовується раніше отриманий та збережений вами CARD_TOKEN, який можна отримати з callback при верифікації картки.

Додатково рекомендуємо ознайомитись з розділом особливості токенів.

Увага! Цей запит на виплату в цілях безпеки використовує перевірку унікальності по order_id для виключення випадків дублів запитів на видачу. У випадку відправки мерчантом декількох однакових запитів з різницею в часі від меньше 1 сек до 10 хв (що не дозволить системі за такий термін провести перевірку на унікальність) - PSP Platon не бере на себе відповідальність за відшкодування лишніх виданих коштів.

Інтегрувати дане API.

Надати тех підтримці PSP Platon посилання для Callback.

Повідомити тех підтримці PSP Platon ваші IP адреси серверів для додавання в білий список.

Провести виплату використовуючи наші тестові реквізити / реальну картку (активується після підписання договору).

Отримати Callback та / або Response.

HTTP METHOD: POST

API ENDPOINT: https://secure.platononline.com/p2p-unq/

Параметр	Значення	Опис	Особливості
`action` ОБОВ'ЯЗКОВИЙ	`CREDIT2CARD`	Код платіжного метода
`client_key` ОБОВ'ЯЗКОВИЙ	String	API ключ мерчанта	Ключ надається на пошту мерчанту
`order_id` ОБОВ'ЯЗКОВИЙ	String	Унікальний ордер виплати у системі мерчанта	Max 255 символів
`order_amount` ОБОВ'ЯЗКОВИЙ	Number	Сума виплати
`order_currency` ОБОВ'ЯЗКОВИЙ	`UAH`	Валюта виплати
`order_description` ОБОВ'ЯЗКОВИЙ	String	Опис виплати	Max 1024 символів
`card_token` ОБОВ'ЯЗКОВИЙ	String	Токен картки	`card_token` з коллбекупервинної транзакції
`first_name` не Обов'язковий	String	Ім'я клієнта	Max 256 символів
`last_name` не Обов'язковий	String	Прізвище клієнта	Max 256 символів
`phone` не Обов'язковий	String	Телефон клієнта	Max 32 символа
`email` не Обов'язковий	String	Валідний емейл клієнта	Max 128 символів
`hash` не Обов'язковий	String	Контрольний підпис	`md5( strtoupper( $client_pass. strrev($card_token) ) )`
`taxn` Не обов'язковий	String	ІПН клієнта	Max 16 символів
`channel_id` Не обов'язковий	String	Додатковий платіжний канал	Використовується для додаткового банківського термінала

<?php
  $client_pass = '***';
  $data['action'] = 'CREDIT2CARD';
  $data['client_key'] = '***';
  $data['order_id'] = 'X1345';
  $data['order_amount'] = '1000.00';
  $data['order_currency'] = 'UAH';
  $data['order_description'] = 'credit test';
  $data['card_token'] = '*****';
  $data['card_exp_month'] ='01'; // тільки для тестових реквізитів;
  $data['card_exp_year'] = '2024'; // тільки для тестових реквізитів;
  $data['hash'] = md5(
                    strtoupper(
                        $client_pass.
                        strrev($data['card_token'])
                    )
                    );

  $url = 'https://secure.platononline.com/p2p-unq/';
  $crq = curl_init();
    curl_setopt($crq, CURLOPT_URL, $url);
    curl_setopt($crq, CURLOPT_HEADER, 0);
    curl_setopt($crq, CURLOPT_POST, 1);
    curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($crq, CURLOPT_POSTFIELDS, http_build_query($data));
  $result = curl_exec($crq);
  if (curl_errno($crq)) {
    echo 'ERROR: '.curl_error($crq);
  }else{
    echo $result;
  }
  curl_close($crq);

Для тестування використайте card_token отриманий з Callback при успішній транзакції з використанням наших тестових реквізитів.

При успішній виплаті:

array (
  'action' => 'CREDIT2CARD',
  'result' => 'SUCCESS',
  'status' => 'SETTLED',
  'order_id' => '1328876',
  'trans_id' => '27894-89059-67608',
  'trans_date' => '2020-01-13 20:55:05',
  'hash' => '********************************',
  'card_hash' => 'cc1c30cfbfe57b068b1f6c4c336791282256b2efc8cf52e85cc2e5fa2a62047a',
  'fee_type' => 'TRANSACTION',
  'fee' => '0.5',
)

Параметр	Описание

Параметр	Описание
`action`	`CREDIT2CARD`
`result`	`SUCCESS`
`status`	`SETTLED`
`order_id`	Уникальный ордер ID транзакции в системе мерчанта
`trans_id`	Уникальный ордер ID транзакции в системе Platon
`trans_date`	Время проведения транзакции в формате UTC (YYYY-MM-DD HH-MM-SS)
`card_hash`	Уникальное зашифрованное значение номера карты, которое будет возвращаться в коллбеке при оплате, верификации, погашении и выплате средств на карту. Этот параметр даст вам возможность в вашей системе: Привязать карту под клиента. Проверить не использовал ли другой клиент эту же карту. Проверить какие кредиты, товары и услуги погашаются данной картой. Отслеживать мошенничество, когда клиент использует ту же карту с другого аккаунта, например, чтобы повторно воспользоваться акцией.
`fee_type`	Признак каким образом взимается комиссия: `ACT` - по актам. `TRANSACTION` - потранзакционно.
`fee`	Сумма комиссии с мерчанта по транзакции в ГРН
`hash`	Зашифрованная проверочная подпись

Документація

A2C виплата на картку по CARD_TOKEN

Зміст

Опис

При успішній виплаті:

При невдалій виплаті:

Проміжна відповідь у випадку технічних неполадок: