Thử nghiệm
Thanh toán testnet là giao dịch thật trên testnet của từng chuỗi, dùng token thử không có giá trị. Trạng thái, khoản nạp, gom tiền và webhook hoạt động giống mainnet.
Chuyển sang testnet
- Bật công tắc Testnet ở đầu trang quản trị người bán. Tài khoản và dự án dùng chung; API key, webhook, thiết lập nhận tiền và bản ghi nhận tiền tách riêng.
- Trong trang Thiết lập nhận tiền của dự án, đăng ký địa chỉ nhận tiền testnet và chọn token. Ví cần một ít gas testnet.
- Tạo API key (bắt đầu bằng
sk_test_) và thiết lập webhook.
Thực hiện thanh toán thử
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" }'Mở checkout_url trả về; trang thanh toán hiển thị nhãn Testnet. Trả bằng ví, hoặc trên BNB Chain gửi tUSDT đến deposit_address của thanh toán. Nhận tUSDT ở cuối trang này.
Phí giống mainnet. Với phí mặc định, thanh toán ví 10 USDT mất phí 0,035 và bạn nhận 9,965; chuyển 10 USDT mất phí 0,335 và bạn nhận 9,665.
Các trường hợp nên thử
| Trường hợp | Cách làm | Xác nhận hệ thống của bạn |
|---|---|---|
| Thanh toán bình thường | Trả đủ bằng ví | Đánh dấu đơn đã trả khi có payment_intent.paid |
| Trả thiếu | Gửi một nửa đến deposit_address, rồi gửi phần còn lại | Không giao sau lần chuyển đầu, giao khi đủ tiền |
| Hết hạn | Tạo thanh toán với expires_in: 60 và không trả | Hủy đơn khi có payment_intent.expired |
| Trả muộn | Chuyển đến deposit_address sau khi hết hạn | Giao hàng hoặc hoàn tiền khi có payment_intent.paid_late |
| Nạp tiền | Gửi 10 tUSDT đến địa chỉ nạp của người dùng | Cộng số dư khi có deposit.confirmed |
| Nạp nhỏ | Gửi 3 tUSDT hai lần đến địa chỉ nạp | Ghi có cả hai và nhận deposit.settled sau khi gom |
| Thử lại | Để URL của bạn trả về 500 lúc đầu | Chỉ ghi có một lần sau khi kokiwa thử lại |
| Chữ ký | Xác minh bằng khóa sai | Từ chối yêu cầu và không ghi có |
Nhận token thử
Ví của bạn nhận tUSDT từ hợp đồng, tối đa 1000 mỗi lần và không giới hạn số lần. Gas là coin gốc của testnet, lấy từ faucet chính thức, ví dụ faucet BNB Chain.
Ví của bạn gọi faucet trên hợp đồng token thử và token được mint vào chính địa chỉ của bạn. Tối đa 1000 mỗi lần, không giới hạn số lần; ví của bạn trả gas (tBNB).
Không tìm thấy ví.
Thanh toán tạo bằng key sk_test_ được trả trên testnet TON, hãy chuyển ví sang testnet. Nhận TON thử từ @testgiver_ton_bot trong Telegram và tUSDT tại đây:
Ví TON của bạn gửi thông điệp Faucet công khai đến hợp đồng tUSDT (kQBOp0yfL-_QhS_0IF-1TrYrfFIg7qpDKMoS3mGrMbXWd003) kèm 0,1 TON để trả gas; phần không dùng sẽ được hoàn lại. Tối đa 1000 mỗi lần, không giới hạn số lần. Quét mã QR bằng ví TON đã chuyển sang testnet, hoặc mở liên kết trên điện thoại.
Mở trong víRa mắt
Đăng ký địa chỉ nhận tiền trên mainnet, tạo key bắt đầu bằng sk_live_ và webhook mainnet, rồi thay key và khóa bí mật ký. URL API giữ nguyên.