Автоматические уведомления

Для информирования торговца о проведенном платеже или об изменении статуса транзакции PayCross высылает POST-запрос на адрес, указанный в параметре notification_url.

Уведомления высылаются при изменении статуса транзакции на pending, expired, failed или successful.

Выполняемый POST-запрос включает в себя авторизационные данные магазина (Shop ID и Secret Key), а также сообщение с телом в формате JSON с параметрами транзакции.

Warning

Чтобы избежать приёма ложных уведомлений, всегда проверяйте принятые авторизационные данные. Только их проверка даст гарантию того, что уведомление поступило от PayCross.

Параметры автоматического уведомления о транзакции, проведенной альтернативным способом оплаты

object

uid

обязательный

string
UID транзакции.

type

обязательный

string
Тип транзакции.

status

обязательный

string
Статус транзакции.

amount

обязательный

integer
Сумма в минимальных денежных единицах.

currency

обязательный

string
Валюта транзакции в формате ISO-4217 alpha-3 code. Например, USD.

description

обязательный

string
Значение из запроса на оплату.

created_at

обязательный

string
Время создания транзакции (подробнее см. описание формата в поле expired_at запроса на оплату).

updated_at

обязательный

string
Время последнего обновления данных транзакции (подробнее см. описание формата в поле expired_at запроса на оплату).

method_type

обязательный

string
Тип способа оплаты.

object

status обязательный	string Статус транзакции, предоставленный провайдером способа оплаты.
gateway_id обязательный	integer Идентификатор платёжного шлюза, который обработал транзакцию.
ref_id	string Идентификатор транзакции, предоставленный провайдером способа оплаты.
message	string Сообщение об обработке транзакции, предоставленное провайдером способа оплаты.

{method}

object
Название способа оплаты, с помощью которого была проведена транзакция. Значение и список возвращаемых параметров зависят от способа оплаты, подробнее можно узнать здесь.

object
Секция информации о покупателе.

ip	string IP-адрес покупателя.
email	string Адрес электронной почты покупателя.

message

string
Сообщение от системы.

tracking_id

string
Значение tracking_id из запроса на проведение транзакции.

test

boolean
true, если запрос на проведение транзакции является тестовым.

language

string
Значение параметра language из запроса на проведение транзакции.

paid_at

string
Дата проведения транзакции (подробнее см. описание формата в поле expired_at запроса на оплату). Если транзакция еще не завершена, то этот параметр отсутствует.

object
Секция информации о покупателе.

first_name	string Имя покупателя.
middle_name	string Отчество покупателя.
last_name	string Фамилия покупателя.
country	string Страна покупателя.
city	string Город покупателя.
zip	string Почтовый индекс или zip-код покупателя.
address	string
phone	string Номер телефона покупателя.
birth_date	string Дата рождения покупателя в формате `YYYY-MM-DD`.

additional_data

object
Секция дополнительной информации о транзакции.

Пример автоматического уведомления о проведении оплаты

{
  "transaction": {
    "uid": "566fd40a-2379-46d6-aecd-67779afcf883",
    "type": "payment",
    "status": "pending",
    "amount": 1234,
    "currency": "EUR",
    "description": "Description",
    "created_at": "2018-08-08T13:30:54Z",
    "updated_at": "2018-08-08T13:30:54Z",
    "method_type": "method_name",
    "payment": {
      "status": "pending",
      "gateway_id": 1,
      "message": "Transaction has been initialized"
    },
    "method_name": {
      "type": "method_name",
      "account": "user",
    },
    "customer": {},
    "message": "Transaction has been initialized",
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "country": "DE",
      "birth_date": "1974-02-15"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    }
  }
}