Skip to content

Создать Ecom

Создать ECOM сделку на пополнение баланса

POST /api/v1/trades/deposit/build

Параметры для генерации подписи

amount_cents::amount_currency::callback_url::cusotmer::merchant::order::return_url::type

Параметры

  • merchantrequred

    UUID мерчанта

  • orderrequred

    Идентификатор сделки в системе мерчанта

  • amount_centsrequred

    Сумма в копейках. Например, сумма 3руб. 12коп. - это число 312

  • amountcurrencyrequred

    Валюта трейда.

    Доступные значения: RUB

  • typerequred

    Возможные значения:

    • any_bank - перевод на карту любого доступного банка
    • nspk - СБП переводы по номеру телефона

  • customer

    Уникальный индентификатор покупателя. В качестве значения может быть имя, email, любое id в системе мерчанта

  • callback_url

    URL, куда будет отправлен POST запрос при изменении статуса сделки.

  • return_url

    URl для редиректа с платежной страницы после проведения платежа

Успешные статусы: 201

Ошибка: 401, 422

Пример:

curl -X POST https://api.oplatex.com/api/v1/trades/deposit/build \
  -H "X-Auth: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "merchant":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "order":"ext-123",
    "amount_cents":1000,
    "amount_currency":"USD",
    "type":"nspk",
    "cusotmer":"cust-1"
  }'

Пример успешного ответа (201):

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "order": "ext-123",
  "merchant": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "state": "created",
  "amount_cents": 1000,
  "amount_currency": "RUB",
  "rate": 88.23,
  "payment_data": {
    "url": "https://pay.example.com/payment_page"
  }
}