Merchant API

Supported Currencies Info

Returns a KingPay-style /info dictionary of all supported native coins and token networks. Each item includes network policy values (minimum transaction, fees, estimated network fee), contract address (for tokens), optional fiat prices, and last update timestamp. Use this endpoint to power “supported currencies” pages and to validate tickers like btc or erc20/ape.

GET https://api-service.kingpay.online/info

This endpoint is public. Prices are computed from your database: CpCurrency.usdPrice and all active fiat rates in CpFiatCurrency (ratePerUsd).

Notices

  • UTXO coins are returned at the top level: btc, ltc, bch, doge.
  • Networks with grouped assets are keyed by network name (e.g. erc20, bep20, sol). Each asset is keyed by symbol, including the native coin when it belongs to that group: sol.sol, sol.usdc, sol.usdt.
  • Grouped assets use network/symbol tickers, such as bep20/bnb and sol/sol. This format is stable even when only the native coin is enabled.
  • prices is an object of fiat prices. It is empty when prices=0.

Query parameters (required)

None.

Query parameters (optional)

prices 0 | 1 • optional

When set to 1, returns fiat prices for each asset in the prices object. Prices are computed from usdPrice and all active rows in CpFiatCurrency.

Default: 1.

Request example (cURL)
curl -G \
  'https://api-service.kingpay.online/info' \
  --data-urlencode 'prices=1'
Response (200 • application/json)
{
  "btc": {
    "coin": "BTC",
    "logo": "/img/coins/btc.svg",
    "ticker": "btc",
    "minimum_transaction": "1484",
    "minimum_transaction_coin": "0.00001484",
    "minimum_fee": "546",
    "minimum_fee_coin": "0.00000546",
    "fee_percent": "1.000",
    "network_fee_estimation": "0.00000392",
    "contract": null,
    "prices": {
      "USD": "86115.48",
      "EUR": "79812.1234"
    },
    "prices_updated": "2025-12-16T12:00:51.679Z"
  },

  "erc20": {
    "ape": {
      "coin": "APE",
      "logo": "/img/coins/ape.svg",
      "ticker": "erc20/ape",
      "minimum_transaction": "17617931934731936000",
      "minimum_transaction_coin": "17.617931934731935",
      "minimum_fee": null,
      "minimum_fee_coin": null,
      "fee_percent": "1",
      "network_fee_estimation": "0.00064",
      "contract": "0x4d224452801ACEd8B2F0aebE155379bb5D594381",
      "prices": {
        "USD": "1.23",
        "EUR": "1.14"
      },
      "prices_updated": "2025-12-16T12:00:55.000Z"
    },
    "usdt": {
      "coin": "USDT",
      "logo": "/img/coins/usdt.svg",
      "ticker": "erc20/usdt",
      "minimum_transaction": "1000000",
      "minimum_transaction_coin": "1",
      "minimum_fee": null,
      "minimum_fee_coin": null,
      "fee_percent": "1",
      "network_fee_estimation": "0.00042",
      "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "prices": {
        "USD": "1",
        "EUR": "0.93"
      },
      "prices_updated": "2025-12-16T12:00:55.000Z"
    }
  },

  "sol": {
    "sol": {
      "coin": "SOL",
      "logo": "/img/coins/sol.svg",
      "ticker": "sol/sol",
      "minimum_transaction": null,
      "minimum_transaction_coin": "0.001",
      "minimum_fee": null,
      "minimum_fee_coin": null,
      "fee_percent": "1",
      "network_fee_estimation": "0.00001",
      "contract": null,
      "prices": {
        "USD": "100"
      },
      "prices_updated": "2026-09-19T09:00:00.000Z"
    },
    "usdc": {
      "coin": "USDC",
      "logo": "/img/coins/usdc.svg",
      "ticker": "sol/usdc",
      "minimum_transaction": null,
      "minimum_transaction_coin": "0.5",
      "minimum_fee": null,
      "minimum_fee_coin": null,
      "fee_percent": "1",
      "network_fee_estimation": "0.002",
      "contract": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "prices": {
        "USD": "1"
      },
      "prices_updated": "2026-09-19T09:00:00.000Z"
    }
  },

  "fee_tiers": [
    { "minimum": "0.00", "fee": "1.000" }
  ]
}

Response fields

  • <nativeTicker> — a top-level object for UTXO coins (example: btc, ltc). The key is the coin ticker.
  • <networkKey> — a group of assets keyed by symbol (example: erc20, bep20, sol). A group can contain both its native coin and tokens.
  • coin — asset symbol in uppercase (e.g. BTC, APE).
  • logo — relative path to the coin SVG icon (e.g. /img/coins/btc.svg).
  • ticker — recommended ticker string for API calls: UTXO coins return btc; other assets return network/symbol (e.g. erc20/ape).
  • contract — token contract address (or null for native coins).
  • minimum_transaction — minimum transaction amount in smallest units (string integer or null).
  • minimum_transaction_coin — minimum transaction amount in coin units (string decimal or null).
  • minimum_fee — minimum fee in smallest units (string integer or null).
  • minimum_fee_coin — minimum fee in coin units (string decimal or null).
  • fee_percent — catalog fee percentage (string decimal), not the effective commission for your project. Project volume tiers, personal terms and exemptions can differ.
  • network_fee_estimation — network estimate in the network's native coin, including for tokens (string decimal or null). It is not the completed webhook's network_fee, which is denominated in the payment asset.
  • prices — fiat price map (e.g. { "USD": "1.00", "EUR": "0.93" }). Empty object when prices=0.
  • prices_updated — ISO timestamp when prices were last updated (or null).
  • fee_tiers — compatibility list with minimum and fee. Currently returns the fixed entry {"minimum":"0.00","fee":"1.000"}; it does not expose configured volume tiers or your project's effective commission.

Project commission and settlement

The rate starts with the configured base rate and uses the highest reached project turnover tier. Turnover is cumulative gross USD from completed payments with usable historical USD valuations; pending/confirmed and unvalued payments do not contribute. A personal rate, when configured, lowers the result only if it is smaller. Conditions are saved when an address is issued.

A network exemption threshold overrides the personal threshold, which otherwise overrides the global threshold. TRON always uses a zero threshold, so its small-payment exemption is disabled. Exemption applies strictly below the threshold, not at equality, and does not remove network costs. At distribution, the percentage and threshold apply to the full current payout before expenses, which can include multiple incoming transfers.

Checkout and subscription quotes can add service and/or network surcharges according to project settings. The quote tests exemption against the base invoice USD amount; actual distribution tests the current payout USD amount. These can differ. The network surcharge converts the native estimate to the payment asset, multiplies it by payout-address count and adds a 10% reserve. The saved total is rounded upward and does not change after address issuance.

Reconcile actual distribution from completed notifications: custom flow exposes fee_coin and network_fee separately when available. Checkout/deposit use paid_amount and received_amount; subscriptions prefix these with payment_. Net amounts are omitted before completed. Fiat fallback values and catalog percentages are not proof of the actual commission or final on-chain gas cost.