Settings | Coinkun API

#Account Settings

PATCH /accounts/{account} Available

Update settings for the selected currency. TRX and USDT share callback, service fee policy and Auto Transfer settings. Saving through either currency updates both; BTC/LTC stay independent. Omitted fields and accepted payments retain their settings.

URL: https://coinzaka.com/api/v1/accounts/{account}
Content type: application/json
Authorization: Account transfer-key in the JSON body, or an Authorization: Bearer access token from Login.

Parameters

Parameter	Type	Description	Required
`account`	string	Account ID returned by Create Account.	Required
`currency`	string	Allowed: btc, ltc, trx, usdt@trx, xmr.	Required
`transfer-key`	string	Required unless an Authorization Bearer access token is sent.	Optional
`callback`	null \| object \| object	Maximum 4096 canonical JSON bytes and nesting depth 8. HTTP(S) URL without credentials or fragment; method defaults to POST. Omitted or explicit-null data is stored and returned as null; receipt notification payloads use an empty object in that case. Explicit data objects are preserved. A null or omitted address callback inherits the current account or wallet default; an empty callback object disables it.	Optional
`processing-fee-policy`	string	Allowed: percentage, fixed.	Optional
`fee`	string	Automatic network fee; normal only for TRON. Allowed: normal, priority, custom.	Optional
`fee-rate`	integer \| string	Required only for custom. Positive integer atomic/vB; at most 99999 (Core accepts below one coin per 1,000 vbytes).	Optional
`destinations`	null \| array	Instant transfer recipients (up to 255). BTC/LTC percentages must total 100%; one omitted, null or empty amount receives the remainder (100% for a sole recipient). Ambiguous or zero remainders are rejected. Shares have at most two effective decimal places and responses contain explicit normalized percentages. TRX/USDT require one 100% destination. BTC/LTC settings are independent; TRX and USDT share settings in both Accounts and Wallets. Null disables new automatic transfers. Accepted payments retain their recipients and fees. Requires service activation for the selected currency.	Optional
`destination_rules`	null \| array	One threshold or recurring rule with one recipient. Threshold sends the available balance once it reaches the atomic threshold. Recurring sends a fixed amount or percentage on a UTC schedule, at minute 0, using ISO weekdays (Sunday is 7) or month days 1-28 and L for the last day. Fees are deducted for Threshold and scheduled 100% sweeps, otherwise added on top; regular service fees apply. TRON reserves a complete cycle across up to 100 source addresses, with one cycle-wide service fee and aggregate fee limits. Null disables the rule.	Optional
`profile`	object \| null	Account-level merchant metadata, validated as on creation; replaces the stored profile, and {} or null clears it.	Optional

curl --request PATCH "https://coinzaka.com/api/v1/accounts/${ACCOUNT_ID:?Set ACCOUNT_ID}" \
  --header 'Content-Type: application/json' \
  --data-binary @- <<JSON
{
  "currency": "ltc",
  "transfer-key": "${TRANSFER_KEY:?Set TRANSFER_KEY}",
  "processing-fee-policy": "percentage",
  "callback": {
    "url": "${CALLBACK_URL:?Set CALLBACK_URL}",
    "method": "POST",
    "data": {}
  }
}
JSON

{
  "currency": "ltc",
  "transfer-key": "YOUR_TRANSFER_KEY",
  "processing-fee-policy": "percentage",
  "callback": {
    "url": "https://merchant.example/notify",
    "method": "POST",
    "data": {}
  }
}

{
  "account": "kun-00000000000000000000000000000001",
  "currency": "ltc",
  "created": "2026-09-05T12:00:00.000000",
  "units": "satoshi",
  "fee": "normal",
  "fee-rate": null,
  "processing-fee-policy": "percentage",
  "destinations": null,
  "destination_rules": null,
  "callback": {
    "url": "https://merchant.example/notify",
    "method": "POST",
    "data": {}
  }
}

Bash: set ACCOUNT_ID, TRANSFER_KEY, CALLBACK_URL before running. Replace placeholders in the JSON Request tab. Responses are illustrative. Keep credentials on your server and out of shared code.

#Wallet Settings

PATCH /wallets/{wallet} Available

Update the wallet's settings. Send at least one setting; omitted fields retain their current values. Accepted payments keep their original settings.

URL: https://coinzaka.com/api/v1/wallets/{wallet}
Content type: application/json
Authorization: Wallet transfer-key in the JSON body, or an Authorization: Bearer access token from Login.

Parameters

Parameter	Type	Description	Required
`wallet`	string	Wallet ID returned by Create Wallet.	Required
`transfer-key`	string	Required unless an Authorization Bearer access token is sent.	Optional
`callback`	null \| object \| object	Maximum 4096 canonical JSON bytes and nesting depth 8. HTTP(S) URL without credentials or fragment; method defaults to POST. Omitted or explicit-null data is stored and returned as null; receipt notification payloads use an empty object in that case. Explicit data objects are preserved. A null or omitted address callback inherits the current account or wallet default; an empty callback object disables it.	Optional
`processing-fee-policy`	string	Service fee policy. Allowed: percentage, fixed.	Optional
`fee`	string	Automatic network fee; normal only for TRON. Allowed: normal, priority, custom.	Optional
`fee-rate`	integer \| string	Required only for custom. Positive integer atomic/vB; at most 99999 (Core accepts below one coin per 1,000 vbytes).	Optional
`destinations`	null \| array	Instant transfer recipients (up to 255). BTC/LTC percentages must total 100%; one omitted, null or empty amount receives the remainder (100% for a sole recipient). Ambiguous or zero remainders are rejected. Shares have at most two effective decimal places and responses contain explicit normalized percentages. TRX/USDT require one 100% destination. BTC/LTC settings are independent; TRX and USDT share settings in both Accounts and Wallets. Null disables new automatic transfers. Accepted payments retain their recipients and fees. Requires service activation for the selected currency.	Optional
`destination_rules`	null \| array	One threshold or recurring rule with one recipient. Threshold sends the available balance once it reaches the atomic threshold. Recurring sends a fixed amount or percentage on a UTC schedule, at minute 0, using ISO weekdays (Sunday is 7) or month days 1-28 and L for the last day. Fees are deducted for Threshold and scheduled 100% sweeps, otherwise added on top; regular service fees apply. TRON reserves a complete cycle across up to 100 source addresses, with one cycle-wide service fee and aggregate fee limits. Null disables the rule.	Optional

curl --request PATCH "https://coinzaka.com/api/v1/wallets/${WALLET_ID:?Set WALLET_ID}" \
  --header 'Content-Type: application/json' \
  --data-binary @- <<JSON
{
  "transfer-key": "${TRANSFER_KEY:?Set TRANSFER_KEY}",
  "processing-fee-policy": "percentage",
  "callback": {
    "url": "${CALLBACK_URL:?Set CALLBACK_URL}",
    "method": "POST",
    "data": {}
  }
}
JSON

{
  "transfer-key": "YOUR_TRANSFER_KEY",
  "processing-fee-policy": "percentage",
  "callback": {
    "url": "https://merchant.example/notify",
    "method": "POST",
    "data": {}
  }
}

{
  "wallet": "ltc-00000000000000000000000000000001",
  "currency": "ltc",
  "created": "2026-10-19T12:00:00.000000",
  "units": "satoshi",
  "fee": "normal",
  "default-fiat": "usd",
  "callback": {
    "url": "https://merchant.example/notify",
    "method": "POST",
    "data": {}
  },
  "processing-fee-policy": "percentage",
  "destinations": null,
  "destination_rules": null
}

Bash: set WALLET_ID, TRANSFER_KEY, CALLBACK_URL before running. Replace placeholders in the JSON Request tab. Responses are illustrative. Keep credentials on your server and out of shared code.

#Account Profile Reference

Include profile when creating an account or updating Account Settings. Updates replace the whole profile; an empty object or null clears it.

Field	Type	Description
first_name	string	Given name
last_name	string	Family name
email	string	Contact email address
send_updates	boolean	Preference for product updates
country	string	Uppercase ISO 3166-1 alpha-3 country code
org_type	string	Organization category

#Auto Transfer Modes Reference

Instant, Recurring and Threshold modes are supported where automatic transfers are enabled below. Configure an enabled currency through Account Settings or the Dashboard.

Current service activation

Currency	Activation
BTC	Enabled
LTC	Enabled
TRX	Disabled
USDT TRC20	Disabled

Current configuration for this service. Transfers follow the documented balance, fee and confirmation rules.

Mode	Trigger	Currencies
Instant	Forward each receipt after confirmation	BTC, LTC, TRX, USDT TRC20
Recurring	Send a fixed amount or balance percentage on a UTC schedule	BTC, LTC, TRX, USDT TRC20
Threshold	Send the available balance when it reaches a set amount	BTC, LTC, TRX, USDT TRC20