Відправка Callback по API

Опис

Цей API метод дає вам змогу перевідправити самостійно собі асинхронно коллбек на ваш сервер або отримати синхронну відповідь з даними коллбека знаючи ваш ордер транзакції.

API параметри

HTTP METHOD: POST

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

Параметр	Значення	Опис	Особливості
`action` ОБОВ'ЯЗКОВИЙ	`GET_CALLBACK` String	Код API метода
`client_key` ОБОВ'ЯЗКОВИЙ	String	API ключ мерчанта	Ключ надається на пошту мерчанту
`order_id` ОБОВ'ЯЗКОВИЙ Вказувати або `order_id` або `client_order_id`	String	ID оплати в системі PSP Platon
`client_order_id` ОБОВ'ЯЗКОВИЙ Вказувати або `order_id` або `client_order_id`	String	ID оплати в системі мерчанта	Max 32 символи
`async` ОБОВ'ЯЗКОВИЙ	`Y` `N` String	`Y` відправить асинхронний коллбек на ваш сервер `N` відправить синхронний респонс	Стандартне значення `Y`
`hash` ОБОВ'ЯЗКОВИЙ	String	Контрольний підпис	md5( strtoupper( client_pass. order_id // або client_order_id ) )

Приклад запиту

Приклад запиту на PHP

<?php
  $client_pass='******';
  $data['action']='GET_CALLBACK';
  $data['client_key']='***';
  $data['async']='Y';
  $data['order_id']='Test_006';
  $data['hash'] = md5(
                    strtoupper(
                      $client_pass.
                      $data['order_id']
                    )
                  );

$url = 'https://secure.platononline.com/post/';
  $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);

Callback / Response

У результаті запиту ви отримаєте відповідь з масивом даних транзакції в transaction.

Callback або Response буде отримано у вигляді залежно від типу API запиту який був. З прикладами, будь ласка, ознайомтесь у відповідних розділах.

"result":"success" і "result":"failed" говорять про те чи була знайдена транзакція з таким ордером і не відповідають за сам статус транзакції.

Приклад при знайденому ордері

{
  "action": "GET_CALLBACK", 
  "result": "success", 
  "transaction": 
  {
  0=>{
    "id": "27374-54220-93708", "order": "234565",
    "status": "SALE",
    "RRN": "4567876556", 
    "approval_code":"678875", 
    "description": "Test", 
    "amount": "1.00",
    "currency": "UAH",
    "name": "Марина Ивановна", 
    "email": "platon@gmail.com", 
    "country": "NULL",
    "state": "NULL",
    "city": "NULL",
    "address": "NULL",
    "date": "2019-11-14 15:30:22",
    "ip": "155.209.55.69",
    "sign": "********************************",
    "rc_id": "27374-54220-93708",
    "rc_token": "b2ef4d1061621ffc0ed12d00c155ec93", 
    "card_token": "card_token",
    "fee_type": "TRANSACTION",
    "fee": "0.5"
  }, 
  1 =>
  {
    "id": "27374-54220-93708",
    "order": "234565",
    "status": "SALE",
    "RRN": "4567876556",
    "approval_code":"678875",
    "description": "Test",
    "amount": "1.00",
    "currency": "UAH",
    "name": "Марина Ивановна",
    "email": "platon@gmail.com",
    "country": "NULL",
    "state": "NULL",
    "city": "NULL",
    "address": "NULL",
    "date": "2019-11-14 15:30:22",
    "ip": "155.209.55.69",
    "sign": "********************************",
    "rc_id": "27374-54220-93708",
    "rc_token": "b2ef4d1061621ffc0ed12d00c155ec93", 
    "card_token": "card_token",
    "fee_type": "TRANSACTION",
    "fee": "0.5"
  }
  }
}

Приклад при не знайденому ордері

{
  "result": "error",
  "error_message": "Your transaction was not found"
}