Simple Forwarding
Receive BTC, LTC, TRX or USDT TRC20 at a permanent address and automatically forward each payment to your wallet.
Examples use LTC unless stated otherwise. Use IDs and addresses for the selected currency.
On this page
#Create Forwarding Address
GET
/receive
Available
Create a permanent receiving address linked to a destination and callback URL. No Account ID or Transfer Key is required.
Current service activation
| Currency | Activation |
|---|---|
| BTC | Enabled |
| LTC | Enabled |
| TRX | Enabled |
| USDT TRC20 | Enabled |
Current configuration for this service. Transfers follow the documented balance, fee and confirmation rules.
- URL
https://coinzaka.com/api/v1/receive- Content type
application/json
Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
method | string | Allowed: create. | Optional |
currency | string | Forwarding currency. Default btc. Allowed: btc, ltc, trx, usdt@trx. | Optional |
address | string | Merchant destination on the configured currency network. | Required |
processing-fee-policy | string | Service fee policy for this permanent address. Default percentage for btc and ltc; fixed for trx and usdt@trx (no service fee below 30 TRX / 20 USDT). Allowed: percentage, fixed. | Optional |
callback | string | HTTP(S) merchant callback URL. Put last if unescaped. No credentials, fragment or receipt-field shadowing. | Required |
curl --request GET "https://coinzaka.com/api/v1/receive" \
--get \
--data-urlencode "method=create" \
--data-urlencode "currency=ltc" \
--data-urlencode "address=${DESTINATION_ADDRESS:?Set DESTINATION_ADDRESS}" \
--data-urlencode "callback=${CALLBACK_URL:?Set CALLBACK_URL}"{
"destination": "LTC_DESTINATION_ADDRESS",
"input_address": "LTC_ADDRESS",
"callback_url": "https://merchant.example/callback?order=42"
}Bash: set DESTINATION_ADDRESS, CALLBACK_URL before running. Responses are illustrative.
#Forwarding and Fees
Available
Each receipt is forwarded after 2 BTC or 6 LTC confirmations, or once its TRON block is solidified. Network fees and one service fee are deducted from the receipt. Large BTC/LTC receipts may require consolidation before the final payout. A TRX or USDT address forwards only its own currency.
| Policy | BTC | LTC | TRX | USDT |
|---|---|---|---|---|
| percentage | 0.5% | 0.5% | 1% | 1% |
| fixed | 0.00005 BTC | 0.015 LTC | 10 TRX | 3 USDT |
| Free below | 0.00060 BTC | 0.1 LTC | 30 TRX (fixed only) | 20 USDT (fixed only) |
#Response Fields
Available
| Field | Type | Meaning |
|---|---|---|
| destination | string | Merchant receiving address. |
| input_address | string | Deposit address allocated for the payer. |
| callback_url | string | Merchant notification URL. |