MakeCrypto

Справочник API

API платежных ссылок

Создавайте, просматривайте, проверяйте, приостанавливайте, архивируйте и отправляйте платежные ссылки MakePay.

Маршруты

Используйте эти маршруты для создания и управления размещенными платежными ссылками MakePay из MakeCrypto.

МетодМаршрут
GET/api/partner/v1/companies

Auth

Сессия

Назначение

Список компаний пользователя

Возвращает команды, доступные для инструментов портала аутентифицированного пользователя MakeCrypto.

POST/api/partner/v1/onboarding/company

Auth

Секрет onboarding партнера

Назначение

Создать ссылку onboarding компании

Создает черновик onboarding, предварительно заполненный партнером, и возвращает URL для получения merchant.

GET/api/partner/v1/makepay/payment-links

Auth

Ключ MakePay API

Назначение

Список или создание платежных ссылок

Читает платежные ссылки компании, связанной с ключом API, или создает хостинговые ссылки checkout MakePay.

POST/api/partner/v1/makepay/payment-links

Auth

Ключ MakePay API или публично

Назначение

Список или создание платежных ссылок

Читает платежные ссылки компании, связанной с ключом API, или создает хостинговые ссылки checkout MakePay.

POST/gateway/pay/{makepayKeyId}

Auth

Публичный ключ формы

Назначение

Отправить HTML-форму оплаты

Принимает поля формы из браузера, создает хостинговую платежную ссылку и перенаправляет покупателя в checkout.

GET/api/partner/v1/makepay/payment-links/{uid}

Auth

Ключ MakePay API

Назначение

Прочитать или обновить платежную ссылку

Читает детали платежной ссылки или меняет ее статус на active, paused или archived.

PATCH/api/partner/v1/makepay/payment-links/{uid}

Auth

Ключ MakePay API

Назначение

Прочитать или обновить платежную ссылку

Читает детали платежной ссылки или меняет ее статус на active, paused или archived.

POST/api/partner/v1/makepay/payment-links/{uid}/send-request-email

Auth

Ключ MakePay API

Назначение

Отправить запрос на оплату

Отправляет или повторно отправляет хостинговую ссылку на e-mail клиента.

GET/api/partner/v1/makepay/subscriptions

Auth

Ключ MakePay API

Назначение

Список или создание подписок

Возвращает планы регулярных подписок MakePay или создает подписку и первый счет.

POST/api/partner/v1/makepay/subscriptions

Auth

Ключ MakePay API

Назначение

Список или создание подписок

Возвращает планы регулярных подписок MakePay или создает подписку и первый счет.

GET/api/partner/v1/makepay/customers

Auth

Ключ MakePay API

Назначение

Список или обновление клиентов

Возвращает профили клиентов MakePay или создает/обновляет клиентов по e-mail.

POST/api/partner/v1/makepay/customers

Auth

Ключ MakePay API

Назначение

Список или обновление клиентов

Возвращает профили клиентов MakePay или создает/обновляет клиентов по e-mail.

POST/api/partner/v1/makepay/customers/{customerId}/portal

Auth

Ключ MakePay API

Назначение

Создать ссылку клиентского портала

По запросу генерирует подписанный URL клиентского портала MakePay, действительный 24 часа.

GET/api/partner/v1/timezones

Auth

Публичный

Назначение

Список часовых поясов

Возвращает поддерживаемые идентификаторы часовых поясов IANA.

GET/api/partner/v1/makepay/settings

Auth

Ключ MakePay API

Назначение

Прочитать или обновить настройки MakePay

Читает или обновляет настройки расчетов, редиректов, комиссий и обработки недоплаты.

PUT/api/partner/v1/makepay/settings

Auth

Ключ MakePay API

Назначение

Прочитать или обновить настройки MakePay

Читает или обновляет настройки расчетов, редиректов, комиссий и обработки недоплаты.

GET/api/partner/v1/makepay/destination-assets

Auth

Ключ MakePay API

Назначение

Список целевых активов

Возвращает поддерживаемые расчетные активы и текущий актив по умолчанию.

GET/api/partner/v1/makepay/webhook-requests

Auth

Ключ MakePay API

Назначение

Список доставок webhook

Показывает попытки доставки payment и subscription webhooks, а также статус повторных попыток.

Создать ссылку для оплаты

Маршрут создания вставляет ссылку платежа MakePay, разрешает бренд merchant и настройки расчета по умолчанию, вводит поля выставления счетов во время выполнения и возвращает общедоступный URL для checkout.

POST /api/partner/v1/makepay/payment-links
json
{
  "status": "active",
  "sendPaymentRequestEmail": false,
  "payload": {
    "title": "Website order #1042",
    "description": "Checkout for order #1042",
    "amount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "returnUrl": "https://merchant.example/orders/1042",
    "successUrl": "https://merchant.example/orders/1042/success",
    "failureUrl": "https://merchant.example/orders/1042/failure",
    "expirationTime": "12h",
    "metadata": {
      "cartId": "cart_7M2V",
      "source": "api"
    }
  }
}

Информацию о кнопке браузера без кода или с низким кодом checkout см. в разделе Оплата за отправку формы. Примите простой POST HTML, создайте ссылку для размещенного платежа того же типа и перенаправьте покупателя на checkout с MakePay.

Требуемая конфигурация

У компании должен быть целевой актив по умолчанию MakePay. Если расчет не настроен, маршрут возвращает 409 с errorCode: "onboarding_required".

Поля суммы и актива

Используйте payload.amount для суммы, видимой клиенту. Отправьте payload.asset для точного целевого актива или payload.currency, если актив компании по умолчанию может разрешить строку. Если валюта включена в нескольких цепочках и на предприятии нет соответствующей валюты по умолчанию, отправьте payload.asset явно.

Срок действия

payload.expirationTime принимает 15m, 1h, 12h, 24h, 72h или never. API сохраняет разрешенную временную метку expires_at в ссылке для оплаты.

Ответ создания

json
{
  "ok": true,
  "paymentRequestEmailSent": false,
  "paymentRequestEmailError": null,
  "paymentLink": {
    "id": "8d15bb78-d0f8-45ef-88d7-2a1f1f79644b",
    "uid": "01hzy4k6p4w9y2x7e2z7n8a2xm",
    "status": "active",
    "expires_at": "2026-04-19T12:00:00.000Z",
    "created_at": "2026-04-19T00:00:00.000Z",
    "updated_at": "2026-04-19T00:00:00.000Z",
    "publicUrl": "https://makepay.io/payment/01hzy4k6p4w9y2x7e2z7n8a2xm",
    "payload": {
      "title": "Website order #1042",
      "description": "Checkout for order #1042",
      "amount": "129.99",
      "fiatCurrency": "USD",
      "currency": "USDT",
      "orderId": "order_1042",
      "customerEmail": "buyer@example.com",
      "returnUrl": "https://merchant.example/orders/1042",
      "successUrl": "https://merchant.example/orders/1042/success",
      "failureUrl": "https://merchant.example/orders/1042/failure",
      "expirationTime": "12h",
      "metadata": {
        "cartId": "cart_7M2V",
        "source": "api"
      },
      "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
      "runtimeMode": "merchant_target_net_v2",
      "billingVersion": "v2",
      "merchantName": "Merchant Co",
      "merchantPaymentLinkTheme": "system"
    }
  }
}

Список платных ссылок

Используйте маршрут листинга для сверки данных в бэк-офисе, информационных панелей и дымового тестирования.

curl
curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

Получить информацию о платежной ссылке

Используйте подробный путь, если у вас уже есть ссылка платежа UID и вам нужна нормализованная ссылка, общедоступный URL для checkout, последний платежный сеанс и события временной шкалы.

curl
curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

Приостановить или заархивировать ссылку для оплаты

Используйте путь состояния, чтобы запретить оплату ссылки или скрыть ее от активных операций.

curl
curl -X PATCH "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"status":"paused"}'

status должен быть active, paused или archived.

Отправить электронное письмо с запросом на оплату

MakeCrypto может отправить размещенную ссылку непосредственно на адрес электронной почты клиента payload со ссылкой для оплаты или на альтернативный адрес электронной почты в тексте запроса.

curl
curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID/send-request-email" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"email":"buyer@example.com"}'

По электронной почте можно отправлять только активные ссылки для оплаты. Заполненные ссылки не могут быть перенаправлены.

Нужна помощь с настройкой партнера?

Откройте страницу деталей платежной ссылки в MakeCrypto, чтобы скопировать сгенерированные фрагменты для реального payment UID, или вернитесь в портал для управления настройками merchant.

Открыть портал