테스트
테스트넷 결제는 각 체인 테스트넷의 실제 트랜잭션이며, 가치 없는 테스트 토큰을 사용합니다. 결제 상태, 입금, 회수, 웹훅은 메인넷과 같습니다.
테스트넷으로 전환
- 가맹점 대시보드 상단의 테스트넷 스위치를 켭니다. 계정과 프로젝트는 공유되고, API 키, 웹훅, 수납 설정, 수납 기록은 따로 관리됩니다.
- 프로젝트의 수납 설정 페이지에서 테스트넷 수령 주소를 등록하고 토큰을 선택합니다. 지갑에 해당 테스트넷의 가스가 조금 필요합니다.
- API 키(
sk_test_로 시작)를 만들고 웹훅을 설정합니다.
테스트 결제
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 수신 |
| 재시도 | 수신 URL이 처음에 500을 반환하게 함 | kokiwa 재시도 후에도 입금 처리는 한 번만 |
| 서명 | 잘못된 시크릿으로 검증 | 요청을 거부하고 입금 처리하지 않음 |
테스트 토큰 받기
tUSDT는 지갑에서 컨트랙트를 호출해 받습니다. 한 번에 최대 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_로 시작하는 키와 메인넷 웹훅을 만든 뒤, 키와 서명 시크릿을 교체합니다. API URL은 그대로입니다.