Запрос статуса транзакции
Запрос
Для того, чтобы получить информацию о статусе транзакции или деталях транзакции, торговец должен, используя токен платежа, отправить 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"
}
}