Versions Compared

Old Version 5

changes.mady.by.user Tech Platon

Saved on

compared with

New Version Current

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/

Параметр

Значення

Опис

Особливості

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);
Info

Postman Collection

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"
}