Быстрый старт API

Выберите команду и ключ API

Создайте ключ API MakePay на портале MakeCrypto или на вкладке тестирования API при входе в систему. Вкладка тестирования API загружает ваши команды, фильтрует ключи API MakePay, открывает модальное окно создания ключа, если у выбранной команды еще нет ключа MakePay, и может отправлять запросы, аутентифицированные с помощью идентификатора и секрета выбранного ключа.

База URL

Все маршруты от API partner до MakeCrypto имеют версию производственного источника.

https://www.makecrypto.io/api/partner/v1

Для локальной разработки используйте локальный источник MakeCrypto с той же структурой маршрутизации.

Аутентификация

Интеграции серверов должны отправлять идентификатор ключа API MakePay и секрет API в каждом запросе. Секрет возвращается только при создании ключа API, поэтому храните его в диспетчере секретов на стороне сервера и никогда не отправляйте его клиентским браузерам.

Первый запрос на чтение

Прежде чем создавать реальные платежные ссылки, начните с запроса на чтение. Правильный ответ подтверждает, что идентификатор ключа, секрет, область действия продукта MakePay и компания, владеющая ключом, действительны.

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"

Первый запрос на создание

Создайте ссылки для оплаты со своего сервера, когда заказ, счет или сеанс checkout будет готов к оплате.

curl -X POST "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 "Content-Type: application/json" \
  -d '{
  "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"
    }
  }
}'

Операционный контрольный список

• Создайте ключ API с продуктом makepay.
• Прежде чем создавать ссылки, установите целевой актив компании по умолчанию.
• Храните секрет API вне системы контроля версий и frontend-пакетов.
• Считайте UID платежных ссылок общедоступными идентификаторами, но сохраняйте внутренние идентификаторы заказов в payload.orderId или payload.metadata.
• Прослушивайте webhooks или запрашивайте статус ссылки/сеанса на портале, пока ваш внутренний поток webhook не станет активным.