測試
測試網上的付款都是各鏈測試網上的真實交易，用的是沒有價值的測試幣。支付單狀態、入帳、歸集和 Webhook 都和主網一樣。
切換到測試網
- 打開商戶後台頂部的「測試網」開關。帳號和項目兩邊共用；API key、Webhook、收款設定和收款記錄兩邊分開。
- 在項目的「收款設定」頁登記測試網的收款地址，並勾選代幣。錢包裡需要少量該測試網的 gas。
- 建立 API key（
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 先轉一半，再轉剩下的 | 第一筆後不發貨，補足後才發貨 |
| 過期 | 建立 expires_in: 60 的支付單，不付款 | 收到 payment_intent.expired 後取消訂單 |
| 過期後才付款 | 支付單過期後，向它的 deposit_address 轉帳 | 收到 payment_intent.paid_late 後補發貨或退款 |
| 充值 | 向用戶的充值地址轉 10 tUSDT | 收到 deposit.confirmed 後給用戶加餘額 |
| 小額充值 | 向充值地址轉 3 tUSDT 兩次 | 兩筆都入帳，歸集後收到 deposit.settled |
| 重試 | 讓你的接收地址先返回 500 | kokiwa 重試後只入帳一次 |
| 簽名 | 用錯誤的密鑰校驗 | 拒絕請求，不入帳 |
領取測試幣
tUSDT 由你的錢包調用合約領取，每次最多 1000，次數不限。gas 用該測試網的原生幣，從官方水龍頭領取，例如 BNB Chain 水龍頭。
自己領取 tUSDT
用你的錢包直接調用測試幣合約的 faucet，代幣鑄造到你自己的地址。每次最多 1000，可以無限次領取；gas 由你的錢包支付（tBNB）。
沒有檢測到錢包。
用 sk_test_ key 建立的支付單在 TON 測試網上付款，錢包要切換到測試網。測試 TON 在 Telegram 的 @testgiver_ton_bot 領取，tUSDT 在這裡領取：
在 TON 測試網領取 tUSDT
你的 TON 錢包向 tUSDT 合約（kQBOp0yfL-_QhS_0IF-1TrYrfFIg7qpDKMoS3mGrMbXWd003）發送公開的 Faucet 消息，附 0.1 TON 作為 gas，用不完的會退回。每次最多 1000，可以無限次領取。用切換到測試網的 TON 錢包掃碼，或在手機上直接打開鏈接。
在錢包中打開上線
在主網登記收款地址，建立 sk_live_ 開頭的 key 和主網的 Webhook，再把 key 和簽名密鑰換掉。API 地址不變。