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": "cd8b6ae5-fa34-4988-9b62-a287cfdcca72",
    "clientId": "user12345",
    "currency": "USDT",
    "network": "ethereum",
    "address": "0xe68C1e0C4BA59e17fAF970cB7EC69c3dABf25f02",
    "tag": null,
    "alias": "My main address",
    "createdAt": "2025-06-04T09:36:10.129Z"
  }
}