카드사 가맹 없이 개발 단계에서 카드 결제·취소를 시험할 방법이 있을까요?

[시즌7]

문의 유형: 프론트 플러그인 / 결제(Payment API)

상황

• 토스 프론트에서 결제하는 프론트 플러그인을 개발하고 있습니다. sdk.payment.requestPayment / requestPaymentCancel / sdk.printer.printReceipt를 씁니다.
• 프론트 단말기는 대리점이 만들어 준 테스트 가맹점으로 로그인돼 있습니다.
  • 개발자센터 테스트 가맹점 관리에서 "결제 가능 여부: 가능(DAOU)"으로 나옵니다.
  • 단말기도 다우에 등록됐다고 안내받았습니다.
• **현금 결제(현금영수증 미발급)**는 결제 → 결과 수신까지 정상입니다.
• 카드 결제는 아래 VAN 응답으로 승인되지 않습니다.
  ▎ = 신용 승인 = 가맹점번호미등록 (관리대리점 확인 요망) (1003)
• 이 테스트 가맹점은 사업자 정보가 없어서, 카드사별 가맹점번호를 받을 수 없는 것으로 이해하고 있습니다.

질문

1. 카드사 가맹 계약 없이 개발 단계에서 카드 결제를 시험할 방법이 있을까요? 예: 테스트 승인 서버(테스트 TID), 개발 모드 전용 가상 승인, 테스트 카드 등
2. 없다면, 실제 운영 매장에 배포하기 전에 카드 결제와 카드 결제 취소(requestPaymentCancel)를 검증하는 권장 방법이 궁금합니다.
3. requestPaymentCancel 파라미터를 확인하고 싶습니다.
   • 문서 예제처럼 paymentKey에 원결제의 paymentKey, timestamp에 원결제 card.timestamp(숫자), approvalNumber에 원결제 승인번호를 넣으면 될까요?
   • tid와 installment도 원결제 값을 넣어야 할까요?
   • 현금영수증 없는 현금 결제는 취소 대상이 아닌지(단말기 승인 거래가 없는지)도 궁금합니다.
4. 결제 중 앱이 꺼졌다 켜졌을 때 결과를 다시 찾으려면 sdk.payment.getPayment({ paymentKey })를 쓰면 될까요?
   • 템플릿 예제에 있던 getBackupPaymentKey / getPaymentByKey는 레퍼런스 문서에 없어서 여쭙니다.

환경

• 토스 프론트 SDK: https://cdn.tossplace.com/toss-front-sdk/v0/index.js
• 플러그인: 순수 HTML/JS (front-plugin-js 템플릿 구성)

[토스플레이스-개발자센터]

안녕하세요. 토스플레이스 개발자센터입니다.

문의 주신 카드 결제 테스트와 취소·결과 조회 방법을 안내 드립니다.

1. 카드 결제 테스트 환경
카드사 가맹 없이 승인할 수 있는 별도의 테스트 TID·테스트카드는 제공해 드리기 어렵습니다.
카드 결제·취소 테스트를 위해서는 이용 중인 VAN 대리점을 통해 카드사 가맹정보를 정식으로 등록해야 합니다.

2. 운영 배포 전 테스트
가맹정보 등록 전에는 현금영수증 미발급 현금 결제로 화면 흐름과 결과 처리를 확인하실 수 있습니다. 다만 실제 카드 승인·취소 검증을 대신하지는 않습니다.
가맹정보 등록 후 본인 카드로 승인하고, 테스트가 끝나면 즉시 취소해 주세요.
결제 테스트 가이드

3. 취소 요청값
원결제의 paymentKey, response.card.timestamp와 response.card.approvalNumber를 사용하시면 됩니다. timestamp는 숫자 그대로 전달하고, paymentMethod와 금액 항목도 원거래에 맞춰 전달해 주세요.
installment는 원결제의 할부 개월을 사용하고, tid를 지정하는 경우에도 원결제 TID를 사용합니다. 현금영수증 미발급 현금 결제에는 취소할 현금영수증 승인 거래가 없습니다.
결제 취소 API

4. 재시작 후 결과 조회
sdk.payment.getPayment({ paymentKey })로 같은 단말에 저장된 승인 결과를 조회하는 방식이 맞습니다. VAN에 최종 거래 상태를 다시 조회하는 기능은 아니며, 취소 결과는 getPaymentCancel로 별도 조회합니다.
getBackupPaymentKey는 SDK가 백업한 결제 식별자를 읽는 보조 기능입니다. 현재 사용하시는 v0 SDK에는 getPaymentByKey가 없으므로, 예제의 해당 호출은 getPayment({ paymentKey })로 변경해 주세요.
결과 조회 API

프론트 직접 승인에 필요한 매장·TID·VAN 설정은 앞서 안내한 답변도 함께 참고 부탁 드립니다.