Перейти к содержанию

Запрос статуса транзакции

Запрос

Для того, чтобы получить информацию о статусе транзакции или деталях транзакции, торговец должен, используя токен платежа, отправить GET запрос на https://panel.pay-cross.com/ctp/api/checkouts/:payment_token, где payment_token должен быть заменен на значение токена, который вы создали ранее.

Ответ

Параметры ответа копируют параметры запроса на создание токена за исключением дополнительных:

Параметр Тип Описание
checkout object
token * обязательный
string Токен платежа.
shop_id * обязательный
integer Shop ID магазина.
gateway_response * обязательный
object Секция содержит подсекции payment или authorization с параметрами оплаты или авторизации. Кроме этого, добавлен параметр uid. uid - назначенный шлюзом PayCross ID транзакции. Вы будете использовать uid для поиска транзакций в кабинете PayCross или использовать шлюз PayCross для запроса статуса
finished * обязательный
boolean true или false. Статус токена. Значение true, если транзакция была обработана платёжной системой.
expired * обязательный
boolean true или false. Статус токена. Значение true, если время, отведенное на оплату, истекло.
test * обязательный
boolean true или false. Значение true, если транзакция является тестовой.
status * обязательный
string Если статус не error, то он соответствует статусам ответа шлюза
message * обязательный
string Если status - error, это описание ошибки такое же, как и сообщение об ошибке от шлюза. В противном случае, оно такое, как message в gateway_response
Пример ответа
{
  "checkout":
  {
    "token": "3241e439f8c87d941d92621a4bdc030d4c9a69c67f3b0cfe12de4a13cc34aa51",
    "shop_id": 1,
    "transaction_type": "payment",
    "gateway_response": {
      "payment": {
        "uid": "1891-5fcb2bda3b",
        "auth_code":"654321",
        "bank_code":"05",
        "rrn":"999",
        "ref_id":"777888",
        "message":"Payment was approved",
        "gateway_id":317,
        "billing_descriptor":"TEST GATEWAY BILLING DESCRIPTOR",
        "status":"successful",
        "avs_cvc_verification": {
            "cvc_verification" : {
              "result_code": "M"
            },
            "avs_verification" : {
              "result_code": "M"
            }
        }
      }
    },
    "order": {
      "currency": "GBP",
      "amount": 4299,
      "description": "New description",
      "addtional_data" : {},
      "expired_at":null
    },
    "settings": {
      "success_url": "http://127.0.0.1:3003/success",
      "fail_url": "http://127.0.0.1:3003/fail",
      "decline_url": "http://127.0.0.1:3003/declined",
      "language": "en"
    },
    "customer": {
      "address": "Baker street 221b",
      "country": "GB",
      "city": "London",
      "email": "[email protected]"
    },
    "finished": true,
    "expired": false,
    "test": true,
    "status": "successful",
    "message": "Successfully processed"
  }
}