Merchant Setup

Buy credits for a store's owner key with USDC, USDT, or BTC (compatibility)

Kept for compatibility. Credits bought here go to the regular credit balance of the API key that owns the merchant, the same balance POST /v1/credits/buy tops up and the one that pays for the store's codes, scans and taps. The store has no balance of its own. Pricing: flat 25 credits per $1 ($0.04/call) at every purchase size. POST /v1/credits/buy is the normal way to top up and carries the volume tiers. Send to the platform wallet: EVM USDC/USDT 0xAd982CB19aCCa2923Df8F687C0614a7700255a23 (same on all chains), Solana USDC/USDT 6a1mLjefhvSJX1sEX8PTnionbE9DqoYjU6F6bNkT4Ydr, Bitcoin BTC bc1qg7qnerdhlmdn899zemtez5tcx2a2snc0dt9dt0, Tron USDT-TRC20 TC5yvwkAMakkXtUxYiu2Yn1xbBcwYuD6cn. USDC and USDT auto-detected from EVM and Solana transactions. BTC accepted on Bitcoin (converted to USD at market rate, requires 1 confirmation). USDT-TRC20 accepted on Tron. Supported chains: Ethereum, Base, Polygon, Arbitrum, Optimism, BNB Chain, Avalanche, Solana, Bitcoin, Tron. Crypto sent on unsupported chains cannot be recovered. All purchases are final and non-refundable. Sender verification: the first purchase registers the sender wallet address to the API key. Subsequent purchases must come from the same sender wallet. To change the registered wallet, include "updateWallet": true — the verified transfer from the new address proves ownership.

post/v1/merchants/{id}/credits

Request

  • Base URL: https://api.insumermodel.com
  • URL: https://api.insumermodel.com/v1/merchants/{id}/credits
  • Auth: API key in header X-API-Key

Path parameters

idstring required

Merchant ID

Request body

txHashstring required

Transaction hash proving payment

amountnumber

Stablecoin amount sent (min 5). Not required for BTC — USD value derived from on-chain BTC amount at market rate.

updateWalletboolean

Set true to replace the registered sender wallet with this transaction's sender

Response

Credits purchased

oktrue

Example response

{
  "meta": {
    "version": "1.0"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.