Документация/Все методы API

Получение статуса платежа

GET/status

Заполните параметры запроса и отправьте его в API.

Возвращает статус платежа. Передайте merchant_id, endpoint_id, signature и один идентификатор поиска: order (ваш номер заказа) или invoice_id (ID платежа из ответа API). Успешный HTTP-ответ не означает успешную оплату; проверяйте payment_status.

GEThttps://secure-api.404stage.com/statusПрямой запрос к API

Запрос

Правила подписи
curl --request GET 'https://secure-api.404stage.com/status' \
  --header 'accept: application/json'
ЗаголовкиAccept: application/json

Укажите свои реквизиты и подпись. Запрос отправляется на адрес выше.

Ответ

Запрос выполнен; проверяйте статус операции в ответе.

application/json
{
  "amount_paid": "250.0000",
  "card_token": "00000000-0000-4000-8000-000000000001",
  "currency": "EUR",
  "id": "4025527",
  "order": "order-123",
  "payment_status": "complete",
  "price": "250.0000",
  "refund_status": "complete",
  "refunds": [
    {
      "amount": "185.0000",
      "currency": "EUR",
      "id": "311",
      "status": "complete"
    }
  ],
  "status": "success"
}
Описание и правила метода

Возвращает статус платежа. Передайте merchant_id, endpoint_id, signature и один идентификатор поиска: order (ваш номер заказа) или invoice_id (ID платежа из ответа API). Успешный HTTP-ответ не означает успешную оплату; проверяйте payment_status.

Пример запроса (замените заполнители и пересчитайте подпись):

http
GET /status?merchant_id=16ec5bed-30a5-470c-9b41-c74ead9d4855&endpoint_id=e82b948f-5416-4560-bcd2-bbec03247dd5&order=order-001&signature={{signature}}
Host: api.example.com

Все параметры и схемы

Свернуть схему

Параметры запроса

merchant_id?string

ID мерчанта, выданный при регистрации.

endpoint_id?string

ID endpoint, выданный для вашей интеграции.

order?string

Ваш номер заказа или выплаты.

invoice_id?string

ID платежа из ответа API; используется вместо order.

signature?string

Подпись запроса: используйте общие правила HS256 и фактический путь URL.

Тело ответа

Запрос выполнен; проверяйте статус операции в ответе.

application/json
  1. response

Текущий статус платежа, суммы и связанные возвраты.

amount?|

Фактически выплаченная сумма; возвращается для выплат.

amount_paid?|

Оплаченная сумма; возвращается для входящих платежей.

beneficiary?|

Реквизиты получателя для перевода; набор полей зависит от способа оплаты.

card_token?|

Токен сохранённой карты для оплаты или выплаты.

currency?|

Код валюты платежа.

id*|

ID платёжной транзакции, присвоенный платёжной платформой.

last_payment_error?|

Сообщение об ошибке последней попытки оплаты.

last_payment_error_code?|

Код ошибки последней попытки оплаты.

order*string

Идентификатор заказа или платежа в системе мерчанта.

payment_status?|

Текущий статус платежа.

price?|

Запрошенная сумма оплаты; возвращается для входящих платежей.

refund_status?|

Текущий статус возврата.

refunds?array<>|

Возвраты, связанные с платежом.

requested_amount?|

Запрошенная сумма выплаты; возвращается для выплат.

status*string

Результат выполнения запроса API.