ИНТЕГРАЦИИ
API криптоплатежей. Одна точка входа для получения оплаты в криптовалюте.
Создавайте ссылки на оплату, получайте события вебхуков и проводите расчёт средств на любой адрес кошелька с помощью единого REST API. Работает с любым языком или фреймворком. Первые 30 платежей бесплатно.
ЧТО ВЫ ПОЛУЧАЕТЕ
Создано для продавцов, которым нужна простота.
REST API
Стандартный JSON REST API. Создавайте платежи, проверяйте статус и программно управляйте аккаунтом из любого языка или фреймворка.
Вебхуки
Получайте уведомления о событиях в реальном времени, когда платежи подтверждены, завершены или не прошли. Настраиваемая логика повторных попыток для пропущенных доставок.
Несколько режимов комиссий
Выберите, как обрабатываются комиссии для каждого платежа: списание из Gas Tank, списание из суммы платежа или перенос комиссий на плательщика.
Поддержка смарт-контрактов
Нативная интеграция смарт-контрактов для платёжных потоков в блокчейне. Доступна полная документация по технической архитектуре.
КАК ЭТО РАБОТАЕТ
Три шага до вашего первого платежа.
- 1
Получите ключ API
Создайте бесплатный аккаунт на app.makapay.io и сгенерируйте ключ API из панели управления в разделе Ключи API.
- 2
Создайте платёж
Отправьте POST на /api/payments с адресом кошелька продавца, сетью, токеном, суммой и идентификатором заказа. Получите ссылку на оплату и QR-код в ответе.
- 3
Получайте события вебхуков
Настройте URL вебхука для получения событий payment.completed. Ваша система обновляется автоматически, когда средства подтверждаются в блокчейне.
Начните разработку
От нуля до первого платежа одним запросом
Создайте платёжную ссылку, получите URL и webhook в момент зачисления средств on-chain. Работает с любым языком и фреймворком.
Создание платежа
curl -X POST https://app.makapay.io/api/payments \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
"chainId": "137",
"token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
"amount": "100.00",
"orderId": "order-12345",
"description": "Premium subscription"
}'const res = await fetch("https://app.makapay.io/api/payments", {
method: "POST",
headers: {
"x-api-key": process.env.MAKAPAY_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
merchant: "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
chainId: "137", // Polygon
token: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", // USDT
amount: "100.00",
orderId: "order-12345",
description: "Premium subscription",
}),
});
const { url } = await res.json();
// Redirect your customer to `url` to complete paymentimport requests
res = requests.post(
"https://app.makapay.io/api/payments",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
"chainId": "137", # Polygon
"token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F", # USDT
"amount": "100.00",
"orderId": "order-12345",
"description": "Premium subscription",
},
)
url = res.json()["url"]
# Redirect your customer to `url` to complete paymentОтвет
Вы получаете размещённый URL для оплаты. Перенаправьте клиента на него или покажите его в виде QR-кода.
{
"url": "https://app.makapay.io/pay/01234567-89ab-cdef-0123-456789abcdef"
}Обработка webhook
Укажите URL webhook на ваш сервер, и MakaPay отправит событие payment.completed в момент завершения платежа.
{
"event": "payment.completed",
"paymentId": "01234567-89ab-cdef-0123-456789abcdef",
"orderId": "order-12345",
"merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
"amount": "100.00",
"token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
"chainId": 137,
"status": "completed",
"transactionHash": "0x...",
"timestamp": 1704067200000
}Проверка подписи
Каждый webhook подписан. Проверьте заголовок X-Signature, прежде чем доверять данным.
const crypto = require("crypto");
function verifyWebhook(rawBody, signature, signingKey) {
const expected = crypto
.createHash("sha256")
.update(rawBody + signingKey)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(expected, "hex"),
Buffer.from(signature, "hex"),
);
}Часто задаваемые вопросы
Какой базовый URL для API?
Базовый URL API MakaPay - https://app.makapay.io/api. Аутентификация выполняется с помощью заголовка x-api-key с вашим ключом API из панели управления.
Какие блокчейны поддерживает API?
API поддерживает MakaChain, Ethereum, Polygon (MATIC) и BNB Chain. Транзакции MakaChain не имеют комиссий за газ. Другие сети предполагают переменные расходы на газ.
Могу ли я создавать платежи для нескольких разных адресов кошельков?
Да. Каждый запрос на платёж включает поле адреса кошелька продавца. Вы можете указывать разные адреса назначения для каждого платежа, что полезно для маркетплейсов и многопоставщиковых конфигураций.
Какие события вебхуков доступны?
MakaPay отправляет события об изменениях статуса платежа, включая payment.completed, payment.failed и payment.expired. Вы можете настроить URL вебхука и выбрать события в панели управления.
Примите свой первый криптоплатёж за 10 минут.
Создайте аккаунт, пополните Gas Tank и поделитесь первой ссылкой на оплату. Без ежемесячной платы. Без платы за настройку. Средства поступают напрямую в ваш кошелёк.