GOATRADE API

API предназначен для приёма платежей и осуществления выплат.

Начало интеграции

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

После авторизации в личном кабинете необходимо создать терминал. Каждый терминал получает уникальный API-ключ (API-key), который используется для идентификации запросов и передаётся в заголовке X-Identity.

В разделе «Настройки» личного кабинета доступен секретный ключ (secret), общий для всех терминалов мерчанта. Он используется для подписи запросов и не передаётся в запросе.

Состав API

Раздел	Назначение	Авторизация
Merchant API	Приём платежей, выплаты, выводы, апелляции	X-Identity + X-Signature
Public API	Справочники (например, список банков)	Не требуется

Формат запросов

Базовый адрес:

https://api.goatrade.cc/v1

Каждый запрос должен содержать заголовок Content-Type с корректным типом отправляемых данных:

Тип данных	Заголовок
JSON	Content-Type: application/json
Файлы и формы	Content-Type: multipart/form-data

Требования к авторизации запросов описаны в разделе Авторизация.

Порядок приёма платежа

1. Мерчант создаёт платёж запросом POST /v1/payments.
2. В ответе возвращаются реквизиты для оплаты и адрес платёжной страницы payment_url.
3. Плательщик совершает перевод по полученным реквизитам.
4. При изменении статуса платежа на notify_url мерчанта отправляется коллбэк. Статус также доступен запросом GET /v1/payments/{id}.

Поддержка

Вопросы по интеграции: Telegram @Stark_fintech