kokiwa

TelegramボットでUSDT決済を受け付ける

ボットやMini Appから顧客へ支払いボタンを送れます。顧客はTelegram Wallet、Tonkeeperなど任意のTONウォレットでUSDTを支払い、着金するとボットにすぐ通知が届きます。

加盟店登録支払いを体験する
  • 支払いはリアルタイム着金
  • 1 件あたりの手数料は最大 100 USD

Telegramでの販売のために

ボタンから支払い

ボットが決済ページのリンクをボタンで送ります。顧客は開いてTONウォレットを接続し、1回確認するだけです。

代金はあなたのウォレットへ

1回の確認で代金と手数料が一緒に送られ、TONウォレットへ直接届きます。出金は必要ありません。

ボットが注文を届ける

支払いが確定すると署名付きWebhookがサーバーへ通知するので、ボットはすぐに商品を届けられます。

ボットに決済を追加する

  1. 決済を作成サーバーから chains に TON を指定してAPIを呼び出します。
  2. ボタンを送信ボットが checkout_url をインラインボタンで送ります。
  3. 注文を届ける署名付きWebhookを受け取ったらボットが商品を届けます。

決済を作成してボタンを送る

# 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" }
    ]] }
  }'

加盟店からのよくある質問

顧客はどのウォレットを使えますか？
Telegram Wallet、Tonkeeperのほか、任意のTONウォレットを使えます。
Telegramの支払いで使えるトークンは？
TON上のUSDTです。顧客が他のネットワークも使う場合は chains を省くと、決済ページでBNB Chain、Ethereum、Solanaなどを選べます。
Telegram決済の費用はいくらですか？
0.35%で固定手数料はなく、1件の上限は100 USDです。最低額は5 USDTで、月額費用はありません。
Telegramでも通知を受け取れますか？
はい。ダッシュボードで @KoKiWaPayBot を連携すると、入金ごとにメッセージが届きます。通知のみで、Webhookの代わりにはなりません。
加盟店登録ドキュメントを読む

Connect a wallet with WalletConnect