Создание ордера
Создание ордера для оплаты
Публичный API-ключ
Подпись тела запроса приватным API-ключем
Тип тела запроса
application/json
Тело запроса для создания ордера на оплату
Тикер монет, в которой будет производиться оплата
USDT
Сеть монеты, в которой будет производиться оплата
ethereum
Сумма к оплате
123.12
Допустимый процент недоплаты. Например, ордер на 100 USDT. Если параметр установлен как 1.5%, то ордер завершится с успехом при оплате 98.5 USDT
1.5
URL для отправки вебхука при ошибке или истечении ордера
https://merchant.domain/webhooks/fail
URL для отправки вебхука при успешной оплате
https://merchant.domain/webhooks/success
URL для размещения на странице оплаты в качестве ссылк "Вернуться в магазин"
https://merchant.domain/
Идентификатор ордера в системе мерчанта
Order #123456
Описание ордера
Payment by order #123456
Время жизни ордера в секундах, доступные значения от 1800 (30 минут) до 43200 (12 часов)
Проверять ли входящие транзакции по данному ордеру
Внешний идентификатор пользователя в вашей системе. При указании идентификатора будет использован функционал раздела "Персональные адреса" - будет зарезервирован статический адрес под данного пользователя, но вебхук придет на указанный в этом запросе адрес
10099
Почта плательщика. Если указана в связке с параметром 'externalUserId' - будет создан пользователь с таким email в разделе "Персональные адреса"
[email protected]
POST /api-gateway/make-order HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 396
{
"currency": "USDT",
"network": "ethereum",
"amount": "123.12",
"paymentTolerancePercent": "1.5",
"errorWebhook": "https://merchant.domain/webhooks/fail",
"successWebhook": "https://merchant.domain/webhooks/success",
"returnUrl": "https://merchant.domain/",
"order": "Order #123456",
"description": "Payment by order #123456",
"lifetime": 1,
"checkRisks": true,
"externalUserId": "10099",
"payerEmail": "[email protected]"
}
{
"success": true,
"response": {
"status": "pending",
"link": "https://payment.domain/4b3399ee-3690-4984-8c39-a911c8b0aad4",
"amount": "123.12",
"paymentTolerancePercent": "1.5",
"currency": "USDT",
"network": "ethereum",
"address": "0x00000005707Bf50EfA35a2db020eDe9Ac0780b9f",
"addressId": "258e95ed-a3c2-4c85-bf6f-09f8b8f1c0be",
"tag": null,
"orderId": "4b3399ee-3690-4984-8c39-a911c8b0aad4",
"clientOrderId": "Order #123456",
"externalUserId": "10099",
"payerEmail": "[email protected]",
"description": "Payment by order #123456",
"successWebhook": "https://merchant.domain/webhooks/success",
"errorWebhook": "https://merchant.domain/webhooks/fail",
"returnUrl": "https://merchant.domain/",
"expiresAt": "2025-06-09T13:48:11.523Z",
"createdAt": "2025-06-09T13:18:11.523Z"
}
}
Last updated