Versions Compared

Old Version 4

changes.mady.by.user Tech Platon

Saved on

compared with

New Version 5

changes.mady.by.user Tech Platon

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Опис

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

API параметри

HTTP METHOD: POST

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

Параметр

Значення

Опис

Особливості

action

Status
colourGreen
titleобов'язковий

GET_CALLBACK

String

Код API метода

client_key

Status
colourGreen
titleобов'язковий

String

API ключ мерчанта

Ключ надається на пошту мерчанту

order_id

Status
colourGreen
titleобов'язковий

Info

Вказувати або order_id або client_order_id

String

ID оплати в системі PSP Platon

client_order_id

Status
colourGreen
titleобов'язковий

Info

Вказувати або order_id або client_order_id

String

ID оплати в системі мерчанта

Max 32 символи

async

Status
colourGreen
titleобов'язковий

Y
N

String

Y відправить асинхронний коллбек на ваш сервер

N відправить синхронний респонс

Стандартне значення Y

hash

Status
colourGreen
titleобов'язковий

String

Контрольний підпис

Code Block
languagephp
md5(
  strtoupper(
    client_pass.
    order_id // або client_order_id
  )
)

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

Expand
titleПриклад запиту на PHP
Code Block
<?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" говорять про те чи була знайдена транзакція з таким ордером і не відповідають за сам статус транзакції.

Expand
titleПриклад при знайденому ордері
Code Block
languagejson
{
  "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"
  }
  }
}
Expand
titleПриклад при не знайденому ордері
Code Block
languagejson
{
  "result": "error",
  "error_message": "Your transaction was not found"
}