Создание счета

Для создания нового счета на оплату, необходимо отправить POST запрос на следующий endpoint:

POST https://epays.ac/api/payment/create

Заголовки запроса

X-API-Key: {CLIENT_API_KEY}
Content-Type: application/json
Accept: application/json

Параметры запроса

Параметр Тип Обязательный Описание
amount number Да Сумма платежа
detail string Нет Комментарий к платежу
return_url string Нет URL для возврата пользователя после оплаты
ttl number Нет Время жизни счета в секундах

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

{
  "amount": 1000,
  "detail": "Оплата заказа #12345",
  "return_url": "https://your-shop.com/order/success",
  "ttl": 3600
}

Пример ответа

{
  "id": "302022df-c949-4edb-9488-d8eac0e83a22",
  "merchant": {
    "name": "Ваш магазин",
    "resource": "tg://resolve?domain=your_shop_bot",
    "description": "Описание вашего магазина"
  },
  "bill": null,
  "status": {
    "id": "ACTIVE",
    "name": "Активный",
    "description": "Счет действительный"
  },
  "amount": "1000.00",
  "detail": "Оплата заказа #12345",
  "created": "2024-02-28T23:48:45.925481+03:00",
  "expiration_at": "2024-02-29T00:48:45.925481+03:00",
  "return_url": "https://your-shop.com/order/success",
  "url": "https://epays.ac/payment/302022df-c949-4edb-9488-d8eac0e83a22"
}

Описание полей ответа

Поле Тип Описание
id string Уникальный идентификатор счета
merchant object Информация о магазине
bill object | null Информация о платеже (null до оплаты)
status object Текущий статус счета
amount string Сумма счета
detail string Комментарий к платежу
created string Дата и время создания счета
expiration_at string Дата и время истечения срока действия счета
return_url string URL для возврата пользователя после оплаты
url string URL страницы оплаты счета