kokiwa

Accept USDT crypto payments in your Telegram bot

Send customers a payment button from your bot or Mini App. They pay USDT on TON with Telegram Wallet, Tonkeeper or any TON wallet, and your bot is told as soon as the money arrives.

  • Payments arrive in real time
  • Fees capped at 100 USD per payment

Built for selling on Telegram

Pay from a bot button

Your bot sends the checkout link as a button. The customer opens it, connects a TON wallet and confirms once.

Money goes to your wallet

One confirmation sends your share and the fee together, straight to your TON wallet. There is nothing to withdraw.

Your bot delivers the order

A signed webhook tells your server the moment the payment is confirmed, so the bot can deliver right away.

Add payments to your bot

  1. Create a paymentYour server calls the API with chains set to TON.
  2. Send the buttonYour bot sends checkout_url as an inline button.
  3. Deliver the orderWhen the signed webhook arrives, your bot delivers.

Create a payment and send the button

# 1. Create a USDT payment on TON
curl https://api.kokiwa.com/v1/payment_intents \
  -H "Authorization: Bearer $KOKIWA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "USDT",
    "amount": "25.00",
    "chains": ["ton"],
    "customer": "tg_123456789"
  }'

# 2. Send checkout_url from the response as a bot button
curl https://api.telegram.org/bot$BOT_TOKEN/sendMessage \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": 123456789,
    "text": "Order 10086: 25 USDT",
    "reply_markup": { "inline_keyboard": [[
      { "text": "Pay 25 USDT", "url": "https://pay.kokiwa.com/p/pi_7Gm4Rk2Wp9Ls1Qv8Bd3Zt6" }
    ]] }
  }'

Questions from merchants

Which wallets can customers use?
Telegram Wallet, Tonkeeper and any other TON wallet.
Which tokens work on Telegram payments?
USDT on TON. If your customers also use other networks, leave out chains and they can choose BNB Chain, Ethereum, Solana and more on the checkout.
How much does a Telegram payment cost?
0.35% with no fixed fee, capped at 100 USD per payment. The minimum is 5 USDT, and there are no monthly fees.
Can I be notified in Telegram too?
Yes. Link @KoKiWaPayBot in the dashboard to get a message for every deposit. It is a reminder and does not replace webhooks.

Connect a wallet with WalletConnect