Developer

API для интеграции CrocoPAY на вашем проекте.

Описание

Документ описывает примеры вызовов CrocoPAY API по выполнению ордера от его создания до завершения.
Для теста вызова или получения ссылки оплаты, используйте Postman. Файл для импорта настроек можно скачать тут!

End Point - 1. Создать счёт

URL-адрес: https://crocopay.tech/api/v2/h2h/invoices
систему, на свой сайт: POST

Пример запроса

Заголовки (Headers) и тело запроса (Body)

                        
POST /api/v2/h2h/invoices HTTP/1.1
Host: crocopay.tech
Client-Id: GnHqauRCUVtB8sECR7m
Client-Secret: vpBpXo7REyApkDnLIOpMR3lk1ndaLmY2qoZptV9cHOtjJLUDsW26GBSe2kda1IVQIMR758Z
Content-Type: application/json

{
    "amount": 5000,
    "currency": "RUB",
    "payment_option": "TO_CARD",
    "callback_url": "https://example.com/payment?user_id={user_id}"
}

Параметр	Описание	Статус	Тип	Пример
Client-Id (Header)	Идентификатор клиента	Обязательно	Строка	GnHqauRCUVtB8sECR7m
Client-Secret (Header)	Секретный ключ клиента	Обязательно	Строка	vpBpXo7REyApkDnLIOpMR3lk1ndaLmY2qoZptV9cHOtjJLUDsW26GBSe2kda1IVQIMR758Z
amount (Body)	Сумма платежа в копейках	Обязательно	Integer	5000
currency (Body)	Валюта платежа	Обязательно	Строка	RUB
payment_option (Body)¹	Способ оплаты	Обязательно	Строка	TO_CARD \| SBP \| SBP_Alfa
callback_url (Body)²	URL, на который придет уведомление о платеже.	Обязательно	Строка	https://example.com/payment?user_id={user_id}

*Примечание:
#1: TO_CARD - Выдает реквизиты номера карты, любого банка РФ.
SBP - Выдает реквизиты номера телефона, для перевода по СБП, любого банка РФ.
SBP_Alfa - Выдает реквизиты номера телефона, для перевода по СБП Альфа Банка.
#2: В GET можете передавать любые параметры (ID клиента etc) при успешной оплате будет отправлен callback.
Пример callback:

["inputFiltered"] => array(7) {

    ["timestamp"] => int(1734617868)

    ["subtotal"] => int(1390)

    ["percentage"] => int(0)

    ["charge_percentage"] => int(0)

    ["charge_fixed"] => string(10) "0.00000000"

    ["total"] => int(1390)

    ["sign"] => string(64) "0162f16847ceb010dfc0e754475d09e27c88b8c0fe23829efd3b04876dd230d2"

  }

End Point - 2. Получить информацию о счете

URL-адрес: https://crocopay.tech/api/v2/h2h/invoices/{invoice_id}
систему, на свой сайт: GET

Пример запроса

Заголовки (Headers)

                        
GET /api/v2/h2h/invoices/911c2823-f55b-43b5-9881-d5653107f7dc HTTP/1.1
Host: crocopay.tech
Client-Id: E4bsjbA9EqCoKbnvG2PQG6ZeV
Client-Secret: qz9UAVOO6cVVHnryr1cOdcabpMquIQfaGNwaKeSz2H7MlZaT4GcM9UlZZwSOiSL6qdf6QnunIwsNKntfMJMVVwnNxpKc9

Параметр	Описание	Статус	Тип	Пример
invoice_id	Уникальный идентификатор счёта	Обязательно	UUID	911c2823-f55b-43b5-9881-d5653107f7dc
Client-Id (Header)	Идентификатор клиента	Обязательно	Строка	E4bsjbA9EqCoKbnvG2PQG6ZeV
Client-Secret (Header)	Секретный ключ клиента	Обязательно	Строка	qz9UAVOO6cVVHnryr1cOdcabpMquIQfaGNwaKeSz2H7MlZaT4GcM9UlZZwSOiSL6qdf6QnunIwsNKntfMJMVVwnNxpKc9

End Point - 3. Доступные методы оплаты

URL-адрес: https://crocopay.tech/api/v2/h2h/payment-method/available
систему, на свой сайт: GET

Пример запроса

Заголовки (Headers)

                        
GET /api/v2/h2h/payment-method/available HTTP/1.1
Host: crocopay.tech
Client-Id: YvoKbnvG2PQG6ZeV
Client-Secret: qz9UAVz2H7MlZaT4GcM9UlZZwSOiSL6qdf6QnunIwsNKntfMJMVVwnNxpKc9

Параметр	Описание	Статус	Тип	Пример
Client-Id (Header)	Идентификатор клиента	Обязательно	Строка	YvoKbnvG2PQG6ZeV
Client-Secret (Header)	Секретный ключ клиента	Обязательно	Строка	qz9UAVz2H7MlZaT4GcM9UlZZwSOiSL6qdf6QnunIwsNKntfMJMVVwnNxpKc9