Payment

Создание платёжного ордера

post

После перевода средств на полученный ранее адрес кошелька необходимо создать платёжный ордер, сообщив системе о транзакции.

При успешном создании ордера статус всегда processing (в обработке).

После проверки транзакции система отправит webhook-уведомление на указанный urlCallback (если он был передан).

Возможные статусы в webhook (statusOrder):

• completed — ордер выполнен, баланс пополнен успешно

• canceled — ордер отменён

Header parameters

merchantIdstringRequired

Ваш ID мерчанта

signstringRequired

MD5-подпись тела запроса (base64(payload) + API_SECRET)

Content-TypestringRequired

application/json

Body

application/json

idPaymentintegerRequired

ID адреса кошелька (получен в ответе от /wallet/address)

amountnumberRequired

Точная сумма перевода (например, 100.45)

txIdstringRequired

Хеш транзакции (txId) в сети TRC20

urlCallbackstring · nullableOptional

URL вашего сервера для получения webhook-уведомлений (необязательно)

Responses

200

Ордер успешно создан

application/json

default

Ошибка

application/json

post

/wallet/payment

HTTPcURLJavaScriptPython

POST /api/v1/wallet/payment HTTP/1.1
Host: test.onesec.su
merchantId: text
sign: text
Content-Type: application/json
Accept: */*
Content-Length: 128

{
  "idPayment": 1,
  "amount": 100.45,
  "txId": "example_transaction_hash_1234567890abcdef",
  "urlCallback": "https://your-site.com/webhook"
}

{
  "status": 1,
  "data": {
    "dateCreate": "2024-06-10T08:10:56.039113",
    "status": "processing",
    "uuid": "606c29ab-f647-4833-bd74-4650092803f9"
  },
  "error": null
}