Adding a trusted address

Adding an address to the trusted list to be able to withdraw using the payment widget

Adding a trusted address

post

Header parameters

x-api-public-keystringOptional

Public API-key

x-api-signaturestringOptional

Signing the request body with a private API-key

Content-typestringOptional

Request content type

Example: application/json

Body

clientIdstringOptional

User ID in the merchant system

Example: user12345

currencystringOptional

Address currency

Example: USDT

networkstringOptional

Address network

Example: ethereum

addressstringOptional

The address in the blockchain

Example: 0xe68C1e0C4BA59e17fAF970cB7EC69c3dABf25f02

tagstringOptional

Address tag (memo) (relevant only for networks that support the tag, such as Ripple)

aliasstringOptional

Address alias

Example: My main address

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api-gateway/personal-addresses/add-trusted-address HTTP/1.1
Host: ocp.onchainpay.io
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "clientId": "user12345",
  "currency": "USDT",
  "network": "ethereum",
  "address": "0xe68C1e0C4BA59e17fAF970cB7EC69c3dABf25f02",
  "tag": null,
  "alias": "My main address"
}

200Success

{
  "success": true,
  "response": {
    "id": "87887ec8-11f1-466d-9aa3-879bf3fb84f7",
    "clientId": "user12345",
    "currency": "USDT",
    "network": "ethereum",
    "address": "0xe68C1e0C4BA59e17fAF970cB7EC69c3dABf25f02",
    "tag": null,
    "alias": "My main address",
    "createdAt": "2025-06-09T13:18:11.535Z"
  }
}