Создание кроссчейн обмена

Метод позволяет создать кроссчейн обмен. Кроссчейн обмен позволяет обменять один актив на другой

Создание кроссчейн обмена

POSThttps://ocp.onchainpay.io/api-gateway/swaps/create

Header parameters

Body

application/json

advancedBalanceId*string

Идентификатор авансового баланса, указанный при создании токена комисси

Example: "dcde70b7-e684-434f-9a7c-377d2010e66e"

clientIdstring

Уникальный идентификатор обмена в системе мерчанта (для предотвращения дублирования запросов)

Example: "merchant_unique_id"

addressFromId*string

Идентификатор исходящего адреса, с которого будет списанна указанная сумма

Example: "66d31527-ab99-4909-b8cc-77f26577c6e7"

addressToId*string

Идентификатор адреса назначения, куда будут зачислены монеты после обмена

Example: "7d58f0c6-a4f9-4fd9-97fd-023d9f7c8762"

feeToken*string

Токен комиссии

Example: "U2FsdGVkX1+xRdr1eZ7Cu+7lfFvcDVeTTWnDQz//h9TwLzRZuLat3kWiCes5G7IXER7bxgw3e2Wr+Dydn8f2g5ynPRS72AX+sFepsFHq3V8B9qAlTHqQoSO0A13dFrqFfUunZ+TaUpYpOrs219al7MEP3N4G/2JsEQWeK0XVIy4sV1FPPzP5s/FxsJvsh4WpDG6kVcwSjjTe1iJ5jsy4MQ=="

webhookUrlstring

URL адрес для уведомления об изменении статуса операции обмена

Example: "https://merchant.domain/webhooks/swap"

Response

200

Body

application/json

success*boolean

Признак успешности запроса

response*SwapResponse (object)

Тело ответа на запрос получения данных обмена

Request

JavaScriptCurlPython

const response = await fetch('https://ocp.onchainpay.io/api-gateway/swaps/create', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "advancedBalanceId": "dcde70b7-e684-434f-9a7c-377d2010e66e",
      "addressFromId": "66d31527-ab99-4909-b8cc-77f26577c6e7",
      "addressToId": "7d58f0c6-a4f9-4fd9-97fd-023d9f7c8762",
      "feeToken": "U2FsdGVkX1+xRdr1eZ7Cu+7lfFvcDVeTTWnDQz//h9TwLzRZuLat3kWiCes5G7IXER7bxgw3e2Wr+Dydn8f2g5ynPRS72AX+sFepsFHq3V8B9qAlTHqQoSO0A13dFrqFfUunZ+TaUpYpOrs219al7MEP3N4G/2JsEQWeK0XVIy4sV1FPPzP5s/FxsJvsh4WpDG6kVcwSjjTe1iJ5jsy4MQ=="
    }),
});
const data = await response.json();

Response

200

{
  "success": false,
  "response": {
    "id": "4d86b864-146e-4dcf-91a5-040e329899bc",
    "clientId": "merchant_unique_id",
    "advancedBalanceId": "dcde70b7-e684-434f-9a7c-377d2010e66e",
    "addressFromId": "66d31527-ab99-4909-b8cc-77f26577c6e7",
    "addressToId": "7d58f0c6-a4f9-4fd9-97fd-023d9f7c8762",
    "currencyFrom": "USDT",
    "currencyTo": "USDC",
    "networkFrom": "ethereum",
    "networkTo": "tron",
    "status": "PENDING",
    "rejectMessage": "null",
    "amountFrom": "200",
    "amountTo": "200",
    "price": "1",
    "serviceBlockchainFeeSource": "ADVANCE",
    "serviceBlockchainFee": "2",
    "serviceBlockchainFeeUSD": "2",
    "providerBlockchainFeeSource": "AMOUNT",
    "providerBlockchainFee": "2",
    "providerBlockchainFeeUSD": "2",
    "serviceFeeSource": "ADVANCE",
    "serviceFee": "2",
    "serviceFeeUSD": "2",
    "webhookUrl": "https://merchant.domain/webhooks/swap",
    "createdAt": "2024-12-11T10:54:03.335Z"
  }
}