Подпись для генерации счёта

Необходимо сформировать md5-хеш в следующем формате:

MERCHANT_ID:INVOICE_ID:AMOUNT:METHOD_ID:KEY_1

Параметры подписи:

Параметр	Описание
MERCHANT_ID	ID мерчанта в личном кабинете
INVOICE_ID	ID счёта на вашей стороне
AMOUNT	Сумма в минорных единицах
METHOD_ID	ID платёжного метода
KEY_1	Ключ №1 мерчанта

Параметр

Описание

MERCHANT_ID

ID мерчанта в личном кабинете

INVOICE_ID

ID счёта на вашей стороне

AMOUNT

Сумма в минорных единицах

METHOD_ID

ID платёжного метода

KEY_1

Ключ №1 мерчанта

Подпись для колбека об успехе

Необходимо сформировать md5-хеш в следующем формате:

KEY_2:PAYMENT_ID:HASH_1

Параметры подписи:

Параметр	Описание
KEY_2	Ключ №2 мерчанта
PAYMENT_ID	ID платежа полученный после создания платежа
HASH_1	Хеш полученный от подписи при создании платежа

Параметр

Описание

KEY_2

Ключ №2 мерчанта

PAYMENT_ID

ID платежа полученный после создания платежа

HASH_1

Хеш полученный от подписи при создании платежа

Подпись для колбека об ошибке

Для создания проверочкой подписи колбека об ошибке необходимо сформировать подпись следующим образом:

md5(KEY_2:PAYMENT_ID:HASH_1)

Токен для выплат

Для формирования токена для выплат необходимо взять ID ключа для выплата и KEY (непосредственно сам ключ), далее сформировать следующую строку:

ID:KEY

Основные параметры запроса

Параметр	Описание
URL	https://panel.overnightpay.finance/api/payments
Метод	POST
SSL	Required
Content-Type	application/json

Параметр

Описание

URL

https://panel.overnightpay.finance/api/payments

Метод

POST

SSL

Required

Content-Type

application/json

Данные

Параметр	Тип	Описание	Обязательно
shop_id	integer	ID мерчанта	Да
invoice_id	string	ID счёта на стороне магазина	Да
description	integer	Описание платежа	Да
amount	integer	Сумма в минорных единицах	Да
method	string	Методы оплаты: BankCard	Да
country	string	Страна плательщика , например: RU	Да
currency	string	Валюта платежа, например: RUB	Да
signature	string	Подпись платежа	Да

Параметр

Тип

Описание

Обязательно

shop_id

integer

ID мерчанта

Да

invoice_id

string

ID счёта на стороне магазина

Да

description

integer

Описание платежа

Да

amount

integer

Сумма в минорных единицах

Да

method

string

Методы оплаты: BankCard

Да

country

string

Страна плательщика , например: RU

Да

currency

string

Валюта платежа, например: RUB

Да

signature

string

Подпись платежа

Да

Ответ

Параметр	Тип	Описание	Обязательно
url	string	Ссылка на SCI-интерфейс	Если success === true
payment_widget	string	Устарело, всегда возвращается статичный текст	Если success === true
id	integer	ID платежа в нашей системе	Если success === true
pay_id	string	Процессинговый ID	Если success === true
code	string	Код ошибки	Если success === false
success	boolean	Успешный ли запрос	Да

Параметр

Тип

Описание

Обязательно

url

string

Ссылка на SCI-интерфейс

Если success === true

payment_widget

string

Устарело, всегда возвращается статичный текст

Если success === true

integer

ID платежа в нашей системе

Если success === true

pay_id

string

Процессинговый ID

Если success === true

code

string

Код ошибки

Если success === false

success

boolean

Успешный ли запрос

Да

Коды ошибок

Код ошибки	Описание
FillFields	Не все поля заполнены
ShopNotExists	Магазин не существует
ShopMustBeActive	Магазин должен быть активен
UnknownMethod	Неизвестный метод оплаты
MethodNotEnabled	Метод не включен для магазина
AmountMustBeInteger	Сумма должна быть числом
IncorrectSignature	Некорректная подпись
MinAmount	Сумма ниже минимальной
MaxAmount	Сумма выше максимальной
PaymentExists	Такой платёж уже существует

Код ошибки

Описание

FillFields

Не все поля заполнены

ShopNotExists

Магазин не существует

ShopMustBeActive

Магазин должен быть активен

UnknownMethod

Неизвестный метод оплаты

MethodNotEnabled

Метод не включен для магазина

AmountMustBeInteger

Сумма должна быть числом

IncorrectSignature

Некорректная подпись

MinAmount

Сумма ниже минимальной

MaxAmount

Сумма выше максимальной

PaymentExists

Такой платёж уже существует

Основные параметры запроса

Параметр	Описание
URL	https://panel.overnightpay.finance/api/wihdraw/oct/create/
Метод	POST
SSL	Required
Content-Type	application/json

Параметр

Описание

URL

https://panel.overnightpay.finance/api/wihdraw/oct/create/

Метод

POST

SSL

Required

Content-Type

application/json

Данные

Параметр	Тип	Описание	Обязательно
shop_id	integer	ID мерчанта	Да
invoice_id	string	ID счёта на стороне магазина	Да
card	string	Номер карты	Да
card_holder	string	Держатель карты	Да
amount	integer	Сумма в минорных единицах	Да
signature	string	Подпись платежа	Да

Параметр

Тип

Описание

Обязательно

shop_id

integer

ID мерчанта

Да

invoice_id

string

ID счёта на стороне магазина

Да

card

string

Номер карты

Да

card_holder

string

Держатель карты

Да

amount

integer

Сумма в минорных единицах

Да

signature

string

Подпись платежа

Да

Ответ

Параметр	Тип	Описание	Обязательно
id	integer	ID платежа в нашей системе	Если success === true

Параметр

Тип

Описание

Обязательно

integer

ID платежа в нашей системе

Если success === true

Коды ошибок

Код ошибки	Описание
FillFields	Не все поля заполнены
ShopNotExists	Магазин не существует
ShopMustBeActive	Магазин должен быть активен
AmountMustBeInteger	Сумма должна быть числом
IncorrectSignature	Некорректная подпись
NoBalance	Недостаточно средств на балансе
PaymentExists	Такой платёж уже существует

Код ошибки

Описание

FillFields

Не все поля заполнены

ShopNotExists

Магазин не существует

ShopMustBeActive

Магазин должен быть активен

AmountMustBeInteger

Сумма должна быть числом

IncorrectSignature

Некорректная подпись

NoBalance

Недостаточно средств на балансе

PaymentExists

Такой платёж уже существует

Основные параметры запроса

Параметр	Описание
URL	https://panel.overnightpay.finance/api/payments
Метод	DELETE
SSL	Required
Content-Type	application/json

Параметр

Описание

URL

https://panel.overnightpay.finance/api/payments

Метод

DELETE

SSL

Required

Content-Type

application/json

Данные

Параметр	Тип	Описание	Обязательно
id	integer	ID платежа	Да
signature	string	Подпись платежа	Да

Параметр

Тип

Описание

Обязательно

integer

ID платежа

Да

signature

string

Подпись платежа

Да

Ответ

Параметр	Тип	Описание	Обязательно
id	integer	ID удалённого платежа	Если success === true
code	string	Код ошибки	Если success === false
card	string	Номер банковской карты	Да
success	boolean	Успешный ли запрос	Да

Параметр

Тип

Описание

Обязательно

integer

ID удалённого платежа

Если success === true

code

string

Код ошибки

Если success === false

card

string

Номер банковской карты

Да

success

boolean

Успешный ли запрос

Да

Коды ошибок

Код ошибки	Описание
FillFields	Не все поля заполнены
IdMustBeInteger	ID должен быть числом
PaymentNotExists	Платёж не существует
ShopNotExists	Магазин не существует
IncorrectSignature	Некорректная подпись

Код ошибки

Описание

FillFields

Не все поля заполнены

IdMustBeInteger

ID должен быть числом

PaymentNotExists

Платёж не существует

ShopNotExists

Магазин не существует

IncorrectSignature

Некорректная подпись

Основные параметры запроса

Параметр Описание

Параметр	Описание
URL	https://panel.overnightpay.finance/api/payments/`:id`
Метод	POST
SSL	Required
Content-Type	application/json

URL

https://panel.overnightpay.finance/api/payments/:id

Метод

POST

SSL

Required

Content-Type

application/json

GET-параметры запроса

Параметр	Тип	Описание	Обязательно
signature	string	Подпись платежа	Да

Параметр

Тип

Описание

Обязательно

signature

string

Подпись платежа

Да

Ответ

Параметр	Тип	Описание	Обязательно
id	integer	ID платежа	Если success === true
shop_id	integer	ID мерчанта	Если success === true
invoice_id	string	ID счёта на вашей стороне	Если success === true
description	string	Описание платежа	Если success === true
pay_id	string	Процессинговый ID платежа	Если success === true
method	string	Платёжный метод	Если success === true
amount	integer	Сумма в минорных единицах	Если success === true
hold_expire	string или null	Дата окончания холда	Если success === true
hold_out	integer	Выплачен ли платёж на баланс	Если success === true
status	string	Статус платежа, референс ниже	Если success === true
error	string	Тип ошибки платежа	Если success === true
created_at	string	Дата создания платежа	Если success === true
id	integer	ID платежа	Если success === true
code	string	Код ошибки	Если success === false
success	boolean	Успешный ли запрос	Да

Параметр

Тип

Описание

Обязательно

integer

ID платежа

Если success === true

shop_id

integer

ID мерчанта

Если success === true

invoice_id

string

ID счёта на вашей стороне

Если success === true

description

string

Описание платежа

Если success === true

pay_id

string

Процессинговый ID платежа

Если success === true

method

string

Платёжный метод

Если success === true

amount

integer

Сумма в минорных единицах

Если success === true

hold_expire

string или null

Дата окончания холда

Если success === true

hold_out

integer

Выплачен ли платёж на баланс

Если success === true

status

string

Статус платежа, референс ниже

Если success === true

error

string

Тип ошибки платежа

Если success === true

created_at

string

Дата создания платежа

Если success === true

integer

ID платежа

Если success === true

code

string

Код ошибки

Если success === false

success

boolean

Успешный ли запрос

Да

Статусы счёта

Статус	Описание	Финальный статус
created	Счёт создан	Нет
pending	Ожидает оплаты	Нет
processing	Обработка платежа	Нет
paid	Оплачен	Да
failed	Ошибка оплаты / Счёт отменён	Да

Статус

Описание

Финальный статус

created

Счёт создан

Нет

pending

Ожидает оплаты

Нет

processing

Обработка платежа

Нет

paid

Оплачен

Да

failed

Ошибка оплаты / Счёт отменён

Да

Порядок смены статусов зависит от конкретного флоу и метода.

Коды ошибок

Код ошибки	Описание
FillFields	Не все поля заполнены
IdMustBeInteger	ID должен быть числом
PaymentNotExists	Платёж не существует
ShopNotExists	Магазин не существует
IncorrectSignature	Некорректная подпись

Код ошибки

Описание

FillFields

Не все поля заполнены

IdMustBeInteger

ID должен быть числом

PaymentNotExists

Платёж не существует

ShopNotExists

Магазин не существует

IncorrectSignature

Некорректная подпись

Общая информация

Уведомление отправляется как при успехе, так и при ошибке.

Уведомление придёт на указанный Callback URL в формате JSON методом POST.

Данные

Параметр	Описание	Всегда
id	ID платежа	Да
pay_id	Процессинговый ID	Да
invoice_id	ID платежа в вашей системе	Да
shop_id	ID мерчанта	Да
description	Описание платежа	Да
amount	Сумма платежа в минорных единицах	Да
error_code	Код ошибки	Только если платёж неуспешный
signature	Проверочная подпись	Да

Параметр

Описание

Всегда

ID платежа

Да

pay_id

Процессинговый ID

Да

invoice_id

ID платежа в вашей системе

Да

shop_id

ID мерчанта

Да

description

Описание платежа

Да

amount

Сумма платежа в минорных единицах

Да

error_code

Код ошибки

Только если платёж неуспешный

signature

Проверочная подпись

Да