Payments

Все endpoints используют заголовки:

Authorization: Bearer <merchant_private_key>
Content-Type: application/json

Создать платёж

POST /api/v1/payments

Тело запроса

Параметр	Тип	Обязательный	Описание
product	string	Да	Название продукта, от 2 до 255 символов
amount	integer	Да	Сумма в минимальных единицах валюты
currency	string	Да	Код валюты, от 3 до 4 символов
order_number	string	Нет	Номер заказа мерчанта, от 3 до 255 символов
callback_url	string	Нет	URL callback-уведомления
redirect_success_url	string	Нет	URL редиректа при успехе
redirect_fail_url	string	Нет	URL редиректа при ошибке
extra_return_param	string	Нет	Дополнительные данные, от 1 до 1024 символов
locale	string	Нет	Локаль платёжной страницы
card	object	Нет	Данные карты для H2H
customer	object	Нет	Данные клиента

Объект card

Если передан card, обязательны все поля:

Параметр	Тип	Обязательный
pan	string	Да
expires	string	Да
holder	string	Да
cvv	string	Да

{
  "card": {
    "pan": "4111111111111111",
    "expires": "12/30",
    "holder": "TEST CUSTOMER",
    "cvv": "123"
  }
}

Объект customer

Поддерживаются email, address, state, ip и данные браузера. Поля имени клиента передаются как name и surname.

Получить список платежей

GET /api/v1/payments

Поддерживаемые query-параметры описаны в ответе endpoint и включают фильтры списка платежей.

Получить платёж

По token:

GET /api/v1/payments/{token}

По номеру заказа:

GET /api/v1/payments?order_number={order_number}

Подтвердить платёж

POST /api/v1/payments/{token}/confirm

Endpoint используется для подтверждения двухстадийного платежа.

Отклонить платёж

POST /api/v1/payments/{token}/decline

Endpoint используется для отклонения двухстадийного платежа.

Отменить платёж

POST /api/v1/payments/{token}/cancel

Endpoint отменяет платёж, если его текущее состояние допускает отмену.