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

post

/api-gateway/bridge/create

Header parameters

x-api-public-keystring

Public API-key

x-api-signaturestring

Signing the request body with a private API-key

Content-typestring

Request content type

Example: application/json

Body

advancedBalanceIdstringrequired

Identifier of the advance balance specified when creating the commission token

Example: 1503cf18-597f-447f-b172-112dfe377e1b

clientIdstring

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

Example: merchant_unique_id

addressFromIdstringrequired

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: 42a54680-0511-4aa0-ba46-5cf1b7de1fd3

addressToIdstringrequired

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

Example: 785b5e25-368e-480d-960d-f0429b50b98f

feeTokenstringrequired

Commission Token

Example: U2FsdGVkX1/Ig1jFoV0kRd6bf/D/KKw5FBkH4ULveOC+TRbE+cK1co/blZ6V7wZKaF5bSce5Melx1oznzkGXhIShENTBRR2Zj3vnqH/Zi3CqYuh9/36MFoG7pYm4l7L2n4wwnTDUQooUaaADpxwUxGxXC8wrgsWetzEugP9Fu+3Hwsmc63IsG4r86nMw0n5yN6CqhPIGDw8OtX0VKKCnW9wJni5Of2Wu1PvNajzkS5I=

webhookUrlstring

URL address for operation status notification

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

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://ocp.onchainpay.io/api-gateway/bridge/create' \
  --header 'Content-Type: application/json' \
  --data '{"advancedBalanceId":"1503cf18-597f-447f-b172-112dfe377e1b","clientId":"merchant_unique_id","addressFromId":"42a54680-0511-4aa0-ba46-5cf1b7de1fd3","addressToId":"785b5e25-368e-480d-960d-f0429b50b98f","feeToken":"U2FsdGVkX1/Ig1jFoV0kRd6bf/D/KKw5FBkH4ULveOC+TRbE+cK1co/blZ6V7wZKaF5bSce5Melx1oznzkGXhIShENTBRR2Zj3vnqH/Zi3CqYuh9/36MFoG7pYm4l7L2n4wwnTDUQooUaaADpxwUxGxXC8wrgsWetzEugP9Fu+3Hwsmc63IsG4r86nMw0n5yN6CqhPIGDw8OtX0VKKCnW9wJni5Of2Wu1PvNajzkS5I=","webhookUrl":"https://merchant.domain/webhooks/bridge"}'

200

200

{
  "success": true,
  "response": {
    "id": "a5900833-55c9-469b-bb9a-bc896e124b41",
    "clientId": "merchant_unique_id",
    "advancedBalanceId": "1503cf18-597f-447f-b172-112dfe377e1b",
    "currency": "USDT",
    "networkFrom": "ethereum",
    "networkTo": "tron",
    "amount": "200",
    "amountUSD": "200",
    "blockchainFee": "2",
    "blockchainFeeUSD": "2.12",
    "serviceFeeUSD": "0.50",
    "webhookUrl": "https://merchant.domain/webhooks/bridge",
    "createdAt": "2024-12-26T08:21:33.215Z",
    "status": "PENDING",
    "rejectMessage": null
  }
}