Payments

Read payments and callback attempts

GET
/{ticker}/logs/

Every payment received on the address of this callback, with its last 10 callback attempts.

Path Parameters

ticker*string

Coin route: one segment for coins on their own chain (btc, ltc, bch, doge, eth, trx), otherwise {network}/{token} such as trc20/usdt, erc20/usdc, bep20/usdt, polygon/usdc, base/usdc, arbitrum/usdt0.

Value in"eth""erc20/usdt""erc20/usdc""erc20/1inch""erc20/arb""erc20/bnb""erc20/cbbtc""erc20/dai""erc20/link""erc20/musd""erc20/ondo""erc20/pepe""erc20/pol""erc20/pyusd""erc20/shib""erc20/trx""erc20/usd1""erc20/wxrp""erc20/xaut""bep20/bnb""bep20/usdt""bep20/usdc""bep20/1inch""bep20/ada""bep20/btcb""bep20/cake""bep20/dai""bep20/doge""bep20/eth""bep20/ltc""bep20/shib""bep20/trx""bep20/usd1""bep20/xrp""polygon/pol""polygon/usdt""polygon/usdc""polygon/avax""polygon/usdc.e""polygon/weth""base/eth""base/usdc""base/cbbtc""base/cbltc""base/dai""base/usdt""arbitrum/eth""arbitrum/usdt0""arbitrum/usdc""arbitrum/arb""arbitrum/dai""arbitrum/link""arbitrum/pepe""arbitrum/pyusd""arbitrum/usdc.e""optimism/eth""optimism/usdc""optimism/usdc.e""optimism/usdt""optimism/usdt0""optimism/dai""optimism/link""optimism/op""avax-c/avax""avax-c/usdc""avax-c/usdc.e""avax-c/usdt""avax-c/wavax""avax-c/weth.e""trx""trc20/btc""trc20/tusd""trc20/usdd""trc20/usdt""btc""ltc""bch""doge""sol/sol""sol/usdc""sol/usdt""sol/eurc""sol/wbtc""sol/cbbtc""sol/weth""sol/trump""sol/hnt""sol/wusdt"

Query Parameters

callback*string

The exact callback URL used with /create/.

Formaturi

Response Body

The address and its payments.

application/json
  1. response
status?string
callback_url?string
address_in?string
address_out?string
notify_pending?boolean
notify_confirmations?integer
priority?string
callbacks?array<>
Example Request
curl -X GET 'https://api.trezorpay.com/trc20/usdt/logs/?callback=http%3A%2F%2Fexample.com'
Example Response
{  "status": "success",  "callback_url": "string",  "address_in": "string",  "address_out": "string",  "notify_pending": true,  "notify_confirmations": 0,  "priority": "string",  "callbacks": [    {      "txid_in": "string",      "txid_out": "string",      "value_coin": "string",      "value_forwarded_coin": "string",      "confirmations": 0,      "last_update": "string",      "result": "pending",      "fee_percent": "string",      "fee_coin": "string",      "logs": [        {          "request_url": "string",          "responses": "string",          "response_status": "string",          "next_try": "string",          "pending": "string",          "confirmed": 0        }      ]    }  ]}

Create a payment address GET

Returns the deposit address your customer pays. The `callback` URL is the identity: calling again with the same callback returns the same `address_in` and the original `address_out`, whatever else you send. To change the destination, use a new callback URL. Addresses never expire and can receive many payments; each one is forwarded and reported on its own.

Payment callback Webhook

Sent to your callback URL. With `pending=1`, once when the payment is first seen (`pending=1`), then once it is forwarded (`pending=0`). By default every field is in the query string; with `post=1` it is a form body, with `json=1` a JSON body. Your own callback query parameters are always kept. Answer `200` with the body `*ok*` within 30 seconds; anything else is retried at 6, 12, 24 minutes and so on until the payment is 3 days old. Verify `x-ca-signature` (base64 RSA-SHA256 PKCS#1 v1.5 of the full URL for GET, of the raw body for POST) with the key from `/pubkey/`.