Справочник 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 key or OAuth

Назначение

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

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

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

Auth

MakePay API key, OAuth, or public

Назначение

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

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

POSThttps://www.makepay.io/api/public/anonymous-payment-links

Auth

Публичный

Назначение

Create anonymous payment link

Public MakePay endpoint for one-time anonymous checkout links with explicit settlement priorities, branding, and optional webhooks.

POST/gateway/pay/{makepayKeyId}

Auth

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

Назначение

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

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

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

Auth

MakePay API key or OAuth

Назначение

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

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

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

Auth

MakePay API key or OAuth

Назначение

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

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

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

Auth

MakePay API key or OAuth

Назначение

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

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

GET/api/partner/v1/makepay/subscriptions

Auth

MakePay API key or OAuth

Назначение

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

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

POST/api/partner/v1/makepay/subscriptions

Auth

MakePay API key or OAuth

Назначение

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

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

GET/api/partner/v1/makepay/customers

Auth

MakePay API key or OAuth

Назначение

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

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

POST/api/partner/v1/makepay/customers

Auth

MakePay API key or OAuth

Назначение

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

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

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

Auth

MakePay API key or OAuth

Назначение

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

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

GET/api/partner/v1/timezones

Auth

Публичный

Назначение

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

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

GET/api/partner/v1/makepay/settings

Auth

MakePay API key or OAuth

Назначение

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

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

PUT/api/partner/v1/makepay/settings

Auth

MakePay API key or OAuth

Назначение

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

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

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

Auth

MakePay API key or OAuth

Назначение

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

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

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

Auth

MakePay API key or OAuth

Назначение

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

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

GET/api/partner/v1/makepay/webhook-subscriptions/current

Auth

grant-bound OAuth

Назначение

Read current webhook subscription

Read the webhook subscription owned by the current OAuth grant without revealing its signing secret.

PUT/api/partner/v1/makepay/webhook-subscriptions/current

Auth

grant-bound OAuth

Назначение

Create or update webhook subscription

Create, reactivate, update, or explicitly rotate the current OAuth grant's MakePay payment webhook subscription.

DELETE/api/partner/v1/makepay/webhook-subscriptions/current

Auth

grant-bound OAuth

Назначение

Disable current webhook subscription

Disable the current OAuth grant's webhook subscription and erase its stored signing secret.

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

Маршрут создания вставляет ссылку платежа 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",
    "feePaidBy": "merchant",
    "skipQuoteAcceptance": true,
    "lineItems": [
      {
        "id": "plan",
        "name": "Starter package",
        "unitAmount": "119.99",
        "quantity": 1
      }
    ],
    "extraCharges": [
      {
        "id": "shipping",
        "name": "Shipping",
        "kind": "shipping",
        "unitAmount": "10.00",
        "quantity": 1
      }
    ],
    "optionalItems": [
      {
        "id": "priority_setup",
        "name": "Priority setup",
        "unitAmount": "19.99",
        "quantity": 1,
        "adjustableQuantity": {
          "enabled": true,
          "minimum": 1,
          "maximum": 3
        }
      }
    ],
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "invoicePdfUrl": "https://merchant.example/invoices/1042.pdf",
    "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,
  "companyId": "8d15bb78-d0f8-45ef-88d7-2a1f1f79644b",
  "paymentRequestEmailSent": false,
  "paymentRequestEmailError": null,
  "paymentLink": {
    "id": "3a85f64-5717-4562-b3fc-2c963f66afa6",
    "uid": "01hzy4k6p4w9y2x7e2z7n8a2xm",
    "donation_slug": null,
    "link_type": "one_time",
    "source": "api",
    "status": "active",
    "amount": "129.99",
    "fiatAmount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
    "title": "Website order #1042",
    "label": "Website order #1042",
    "description": "Checkout for order #1042",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "clientId": null,
    "metadata": {
      "source": "api"
    },
    "payload": {
      "title": "Website order #1042",
      "description": "Checkout for order #1042",
      "amount": "129.99",
      "fiatCurrency": "USD",
      "currency": "USDT",
      "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
      "runtimeMode": "merchant_target_net_v2",
      "billingVersion": "v2",
      "merchantName": "Merchant Co",
      "merchantPaymentLinkTheme": "system",
      "customerEmail": "buyer@example.com",
      "orderId": "order_1042",
      "skipQuoteAcceptance": true,
      "metadata": {
        "source": "api"
      }
    },
    "latestSession": null,
    "timelineEvents": [],
    "publicUrl": "https://makepay.io/payment/01hzy4k6p4w9y2x7e2z7n8a2xm",
    "created_at": "2026-04-19T00:00:00.000Z",
    "updated_at": "2026-04-19T00:00:00.000Z",
    "expires_at": "2026-04-19T12:00:00.000Z",
    "dashboardUrl": "https://www.makecrypto.io/home/makepay/payment-links?orderUid=01hzy4k6p4w9y2x7e2z7n8a2xm"
  }
}

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

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

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 "Idempotency-Key: order_1042_update_v1" \
  -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.

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