Интеграция с бэкендом

@cryptumpay/node-sdk

Как интегрировать CryptumPay с вашим бэкенд-сервером для безопасного создания заказов, вывода средств и подтверждения платежей.

Обзор

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

• Безопасность — пользователи не могут манипулировать ценами
• Валидация — проверка наличия товара и бизнес-логики
• Учёт — корректное управление заказами в вашей базе данных

Шаги интеграции

Фронтенд

Реализуйте колбэк onCreateOrder, который вызывает ваш бэкенд и возвращает Order ID.

Бэкенд

Создайте эндпоинт, который:

1. Применяет вашу бизнес-логику (валидация корзины, проверка наличия товара и т.д.)
2. Создаёт заказ через CryptumPay API с помощью Node.js SDK
3. Возвращает Order ID фронтенду

TIP

Бэкенд-эндпоинт может принимать параметры от фронтенда (если они нужны для бизнес-логики) или использовать данные текущей сессии (ID пользователя, содержимое корзины и т.д.)

Project API

Project API — это серверный интерфейс для управления заказами и выводом средств. Все запросы аутентифицируются парой ключ/секрет и HMAC-подписью запроса.

npm install @cryptumpay/node-sdk

import { CryptumPayClient, CryptumPaySigner } from '@cryptumpay/node-sdk';

const client = new CryptumPayClient(
  new CryptumPaySigner(
    process.env.CRYPTUMPAY_API_KEY,
    process.env.CRYPTUMPAY_API_SECRET
  )
);

const response = await client.createOrder({
  title: 'Заказ #12345',
  description: 'Оформление заказа',
  fiatAmount: '49.99',
  fiatCurrency: 'usd',
});

Справочник по API

Страница	Описание
Аутентификация	Получение API-ключей, подпись запросов, настройка IP-whitelist, обработка ошибок аутентификации
Эндпоинты	Все доступные эндпоинты: создание заказа, получение заказа, вывод средств, статус вывода
Webhooks & Redirects	Получение уведомлений о событиях оплаты и обработка редиректов после оплаты

Смотрите также

• Node.js SDK — официальный SDK на npm