テスト
テストネットの支払いは各チェーンのテストネット上の実際のトランザクションで、価値のないテストトークンを使います。支払いのステータス、入金、回収、Webhook はメインネットと同じです。
テストネットに切り替える
- マーチャント管理画面上部の「テストネット」スイッチをオンにします。アカウントとプロジェクトは共通で、API キー、Webhook、受け取り設定、受取記録は別々です。
- プロジェクトの「受け取り設定」でテストネットの受取アドレスを登録し、トークンを選びます。ウォレットには少額のテストネットのガスが必要です。
- API キー（
sk_test_で始まる）を作成し、Webhook を設定します。
テスト支払いをする
curl https://api.kokiwa.com/v1/payment_intents \
-H "Authorization: Bearer $KOKIWA_TEST_KEY" \
-H "Content-Type: application/json" \
-d '{ "currency": "USDT", "amount": "10.00", "customer": "test_user_1" }'返された checkout_url を開くと、チェックアウトに「テストネット」と表示されます。ウォレットで支払うか、BNB Chain で支払いの deposit_address に tUSDT を送ります。tUSDT はこのページの下部で受け取れます。
手数料はメインネットと同じです。既定の手数料では、ウォレットで 10 USDT 支払うと手数料 0.035 で受取額 9.965、10 USDT 送金すると手数料 0.335 で受取額 9.665 です。
テストするケース
| ケース | 方法 | システムで確認すること |
|---|---|---|
| 通常の支払い | ウォレットで全額支払う | payment_intent.paid で注文を支払い済みにする |
| 不足 | deposit_address に半額を送り、その後に残りを送る | 1 回目では発送せず、全額そろってから発送する |
| 期限切れ | expires_in: 60 の支払いを作成し、支払わない | payment_intent.expired で注文を取り消す |
| 期限後の支払い | 期限切れの後に deposit_address へ送金する | payment_intent.paid_late で発送または返金する |
| 入金 | ユーザーの入金アドレスに 10 tUSDT を送る | deposit.confirmed で残高を増やす |
| 少額の入金 | 入金アドレスに 3 tUSDT を 2 回送る | 両方を入金処理し、回収後に deposit.settled を受け取る |
| 再試行 | 受信 URL が最初は 500 を返すようにする | kokiwa の再試行後も入金処理は 1 回だけ |
| 署名 | 誤ったシークレットで検証する | リクエストを拒否し、入金処理しない |
テストトークンを受け取る
tUSDT はウォレットからコントラクトを呼び出して受け取ります。1 回最大 1000 で、回数制限はありません。ガスはそのテストネットのネイティブコインで、公式フォーセットから受け取ります。例：BNB Chain フォーセット。
あなたのウォレットがテストトークンコントラクトの faucet を呼び出し、トークンはあなた自身のアドレスにミントされます。1 回最大 1000、回数制限なし。gas はあなたのウォレットが支払います（tBNB）。
ウォレットが見つかりません。
sk_test_ キーで作成した支払いは TON テストネットで支払うので、ウォレットをテストネットに切り替えてください。テスト TON は Telegram の @testgiver_ton_bot で、tUSDT はここで受け取れます。
TON ウォレットが tUSDT コントラクト（kQBOp0yfL-_QhS_0IF-1TrYrfFIg7qpDKMoS3mGrMbXWd003）に公開の Faucet メッセージを gas 用の 0.1 TON と一緒に送ります。余った分は戻ります。1 回最大 1000、回数制限なし。テストネットに切り替えた TON ウォレットで QR コードを読み取るか、スマートフォンでリンクを開いてください。
ウォレットで開く本番に移行する
メインネットで受取アドレスを登録し、sk_live_ で始まるキーとメインネットの Webhook を作成して、キーと署名シークレットを入れ替えます。API の URL は変わりません。