ИНТЕГРАЦИИ

API криптоплатежей. Одна точка входа для получения оплаты в криптовалюте.

Создавайте ссылки на оплату, получайте события вебхуков и проводите расчёт средств на любой адрес кошелька с помощью единого REST API. Работает с любым языком или фреймворком. Первые 30 платежей бесплатно.

ЧТО ВЫ ПОЛУЧАЕТЕ

Создано для продавцов, которым нужна простота.

REST API

Стандартный JSON REST API. Создавайте платежи, проверяйте статус и программно управляйте аккаунтом из любого языка или фреймворка.

Вебхуки

Получайте уведомления о событиях в реальном времени, когда платежи подтверждены, завершены или не прошли. Настраиваемая логика повторных попыток для пропущенных доставок.

Несколько режимов комиссий

Выберите, как обрабатываются комиссии для каждого платежа: списание из Gas Tank, списание из суммы платежа или перенос комиссий на плательщика.

Поддержка смарт-контрактов

Нативная интеграция смарт-контрактов для платёжных потоков в блокчейне. Доступна полная документация по технической архитектуре.

КАК ЭТО РАБОТАЕТ

Три шага до вашего первого платежа.

  1. 1

    Получите ключ API

    Создайте бесплатный аккаунт на app.makapay.io и сгенерируйте ключ API из панели управления в разделе Ключи API.

  2. 2

    Создайте платёж

    Отправьте POST на /api/payments с адресом кошелька продавца, сетью, токеном, суммой и идентификатором заказа. Получите ссылку на оплату и QR-код в ответе.

  3. 3

    Получайте события вебхуков

    Настройте URL вебхука для получения событий payment.completed. Ваша система обновляется автоматически, когда средства подтверждаются в блокчейне.

Начните разработку

От нуля до первого платежа одним запросом

Создайте платёжную ссылку, получите URL и webhook в момент зачисления средств on-chain. Работает с любым языком и фреймворком.

Создание платежа

cURL
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"
  }'

Ответ

Вы получаете размещённый URL для оплаты. Перенаправьте клиента на него или покажите его в виде QR-кода.

JSON
{
  "url": "https://app.makapay.io/pay/01234567-89ab-cdef-0123-456789abcdef"
}

Обработка webhook

Укажите URL webhook на ваш сервер, и MakaPay отправит событие payment.completed в момент завершения платежа.

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, прежде чем доверять данным.

verify-webhook.js
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 и поделитесь первой ссылкой на оплату. Без ежемесячной платы. Без платы за настройку. Средства поступают напрямую в ваш кошелёк.