Перевірка статусу C2A оплати

Зміст

1 Зміст
2 Опис
3 API параметри
4 Приклади запитів
5 Responce

Опис

Цей функціонал дозволяє отримати інформацію про статус оплати проведеної згідно з запитом C2A погашення DEBIT (Server - Server) або C2A погашення DEBIT за CARD_TOKEN (Server - Server) знаючи ордер платежу у системі PSP Platon.

API параметри

HTTP METHOD: POST

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

Параметр	Значення	Опис	Особливості

Параметр	Значення	Опис	Особливості
`action` status:ОБОВ'ЯЗКОВО	`DEBIT_STATUS`	Код платіжного методу
`client_key` status:ОБОВ'ЯЗКОВО	String	API ключ мерчанта	Ключ надається на пошту мерчанту
`trans_id` status:ОБОВ'ЯЗКОВО	String	ID платежу у системі Platon
`signature` status:ОБОВ'ЯЗКОВО	String	Контрольний підпис	`sha1( $client_passpord. strtolower( implode( '', $action. $client_key. $trans_id. ) ) )`

Приклади запитів

<?php
  $client_password='***************'; //Client's password
  $params['action']='DEBIT_STATUS';
  $params['client_key']='******'; //Client's KEY 
  $params['trans_id']='**********';
  $params['signature'] = sha1($client_password . strtolower(implode('', $params)));
  
  $url = 'https://secure.platononline.com/p2p-debit/';
  
  $tempData = array();
    foreach ($params as $key => $value) {
      $tempData[] = $key.'='.urlencode($value);
    }
    
  $crq = curl_init();
    curl_setopt($crq, CURLOPT_URL, $url);
    curl_setopt($crq, CURLOPT_HEADER, 0);
    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, implode('&', $tempData));
    $result = curl_exec($crq);
    curl_close($crq);

  echo $result;
?>

Postman Collection

Responce

При успішному запиті:

{
  "action":"GET_TRANS_DETAILS",
  "result":"SUCCESS",
  "status":"SETTLED",
  "order_amount":"1000.00",
  "order_currency":"UAH",
  "order_id":"Platon_test_37254615",
  "trans_id":"33999-98398-18623",
  "trans_date":"2021-12-20 11:30:39",
  "card_bin":"123456",
  "card_last4":"7890",
  "payer_phone":"380962111111",
  "redirect_url":"https:\/\/www.liqpay.ua\/apipay\/3ds\/request\/1642516803543176_540034_Vzuq47rB\/?return_to=https%3A%2F%2Fsecure.platononline.com%2F3ds%2F5a0def8%3Foperation_type%3Ddebit2card%26trans_id%3D34251-68010-32563%26hash%3D087070bb5c91b131d5f0c3f51ac99447",
  "redirect_params":null,
  "redirect_method":"GET",
  "action":"DEBIT_STATUS"
}

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

Параметр	Опис
`action`	`GET_TRANS_DETAILS`
`result`	`SUCCESS`
`status`	`SETTLED`, `DECLINED`, `INIT`
`order_id`	Унікальний ордер ID транзакції у системі мерчанта
`trans_id`	Унікальний ордер ID транзакції у системі Platon
`order_amount`	Сума платежу
`card_bin`	Перші 6 цифр картки
`card_last4`	Останні 4 цифри картки
`payer_phone`	Телефон клієнта
`order_currency`	`UAH`
`redirect_url`	Посилання для переадресації на 3DS
`redirect_params`	Параметри для переадресації на 3DS
`redirect_method`	Метод для переадресації на 3DS
`action`	`DEBIT_STATUS`
`decline_reason`	Опис помилки у разі `DECLINED`

При помилці в запиті:

{
  "result":"ERROR",
  "error_message":"error_message"
}

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