Own addresses

Your receiving addresses (address mode own): list, add and switch off.

Updated 2 November 2026Live from Tocler

A new address is checked for its network, must have its last 6 characters sent again, is sealed, and starts receiving only after the safety wait (24 hours by default) — ready: false until then. Addresses are never deleted, only switched off.

GET /api/pay/v1/addresses Your Tocler Pay merchant keyaddresses:read

Your addresses (or a payee’s).

payeestringquery
A sub-account of yours.

Errors

401 unauthorized — No key, a wrong key, or a revoked / expired key (key_revoked, key_expired).
403 missing_scope — The key lacks the scope this call needs.

curl -X GET 'https://api.tocler.com/api/pay/v1/addresses' \
  -H 'Authorization: Bearer tp_live_…'

POST /api/pay/v1/addresses Your Tocler Pay merchant keyaddresses:write

Add an address.

networkstringbodyrequired
e.g. tron.
addressstringbodyrequired
The receiving address.
confirm_last6stringbodyrequired
Its last 6 characters again.
coinsarraybody
Coin keys this address takes.
labelstringbody
Your name for it.
payeestringbody
A sub-account of yours.

Errors

400 invalid_request — A field is missing or wrong — see error.field.
400 invalid_address — Not a valid address for that network, or the last 6 characters differ.
401 unauthorized — No key, a wrong key, or a revoked / expired key (key_revoked, key_expired).
403 missing_scope — The key lacks the scope this call needs.

curl -X POST 'https://api.tocler.com/api/pay/v1/addresses' \
  -H 'Authorization: Bearer tp_live_…' \
  -H 'Content-Type: application/json' \
  -d '{
  "network": "tron",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "confirm_last6": "KcbLSE",
  "coins": [
    "usdt_tron"
  ],
  "label": "Main",
  "payee": "seller-42"
}'

{
  "network": "tron",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "confirm_last6": "KcbLSE",
  "coins": [
    "usdt_tron"
  ],
  "label": "Main",
  "payee": "seller-42"
}

POST /api/pay/v1/addresses/{id}/disable Your Tocler Pay merchant keyaddresses:write

Switch an address off (it is kept).

idstringpathrequired
The address id.
reasonstringbody
Why.
payeestringbody
A sub-account of yours.

Errors

401 unauthorized — No key, a wrong key, or a revoked / expired key (key_revoked, key_expired).
403 missing_scope — The key lacks the scope this call needs.
404 not_found — No such object, or it belongs to another merchant.

curl -X POST 'https://api.tocler.com/api/pay/v1/addresses/{id}/disable' \
  -H 'Authorization: Bearer tp_live_…'

Was this page helpful?