Creating a cross-chain translation

The method allows you to create a cross-chain transfer. Cross-chain transfer allows you to transfer your assets from one network to another

Creating a cross-chain translation

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

Header parameters

Body

application/json

advancedBalanceId*string

Identifier of the advance balance specified when creating the commission token

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

clientIdstring

Unique transaction identifier in the merchant system, to prevent duplication of creation

Example: "merchant_unique_id"

addressFromId*string

Identifier of the outgoing address in the system, in the specified coin and network when creating the commission token. The specified amount will be debited from this address

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

addressToId*string

Identifier of the destination address in the system where the coins should be delivered

Example: "f3571ae6-6cb5-4e48-9f95-2b49b3e52399"

feeToken*string

Commission Token

Example: "U2FsdGVkX1+/swy0JprbBaeDYu8MdIpZaE0TDzE/ACmdMC09UvPQz2DNomGHD4g7VHrxZAgUD6vvNh2u7NmdIbe3Dz3yR/UtXQaVX9vXWYK6p7ASjFI7GQX1Jkx5zy9r6rC9JBesW5k+yvSM+Du8yM/AhK3+hGIVV2CjtCzmXbDFZe3yhkxbum3tD2ZMRzqeKs1lbHf2FXwX/CnfmNoZ5Wdn1GPDE1DVbHn2Mu2QlXc="

webhookUrlstring

URL address for operation status notification

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

Response

200

Body

application/json

success*boolean

Request success indicator

response*BridgeResponse (object)

Response body of receiving data of cross-chain transfer operation

Request

JavaScriptCurlPython

const response = await fetch('https://ocp.onchainpay.io/api-gateway/bridge/create', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "advancedBalanceId": "dcde70b7-e684-434f-9a7c-377d2010e66e",
      "addressFromId": "66d31527-ab99-4909-b8cc-77f26577c6e7",
      "addressToId": "f3571ae6-6cb5-4e48-9f95-2b49b3e52399",
      "feeToken": "U2FsdGVkX1+/swy0JprbBaeDYu8MdIpZaE0TDzE/ACmdMC09UvPQz2DNomGHD4g7VHrxZAgUD6vvNh2u7NmdIbe3Dz3yR/UtXQaVX9vXWYK6p7ASjFI7GQX1Jkx5zy9r6rC9JBesW5k+yvSM+Du8yM/AhK3+hGIVV2CjtCzmXbDFZe3yhkxbum3tD2ZMRzqeKs1lbHf2FXwX/CnfmNoZ5Wdn1GPDE1DVbHn2Mu2QlXc="
    }),
});
const data = await response.json();

Response

200

{
  "success": false,
  "response": {
    "id": "00662001-f65e-4c23-9440-62568fc80ad3",
    "clientId": "merchant_unique_id",
    "advancedBalanceId": "dcde70b7-e684-434f-9a7c-377d2010e66e",
    "currency": "USDT",
    "networkFrom": "ethereum",
    "networkTo": "tron",
    "status": "PENDING",
    "rejectMessage": null,
    "amount": "200",
    "amountUSD": "200",
    "blockchainFee": "2",
    "blockchainFeeUSD": "2.12",
    "serviceFeeUSD": "0.50",
    "webhookUrl": "https://merchant.domain/webhooks/bridge",
    "createdAt": "2024-12-11T10:54:03.333Z"
  }
}