[프론트 플러그인] 결제 승인 후 환불 가능 기간 문의 드립니다.

[coffeeya]

어떤 제품을 사용하나요?

• 제품: 프론트 플러그인
• SDK 또는 API 버전: 토스 프론트 SDK v0 (https://cdn.tossplace.com/toss-front-sdk/v0/index.js),sdk.payment.requestPayment / requestPaymentCancel / getPayment 사용
• 환경: 개발·운영 공통

무엇이 궁금한가요?

토스 프론트 단말기에서 결제 승인 후 환불(전액 취소) 을 sdk.payment.requestPaymentCancel로 처리하고 있습니다.

Payment API에는 requestPaymentCancel 파라미터·전액 취소·현금영수증 취소 방식 등은 안내되어 있으나, 승인 시점 기준 “며칠까지 취소 가능한지” 같은 환불 가능 기간은 찾지 못했습니다.

같은 문서의 getPayment / getPaymentCancel에는 단말 로컬 캐시 TTL 14일이 적혀 있어, 플러그인 설정 화면의 환불 목록 보관도 이 기간에 맞춰 두었습니다. 다만 이 14일이 캐시 조회 한도인지, requestPaymentCancel 호출 가능 기간과 동일한지는 문서만으로는 구분이 어렵습니다.

아래를 공식 기준으로 알고 싶습니다.

프론트 플러그인에서 승인 후 환불(requestPaymentCancel)에 권장·제한 기간이 있는지, 있다면 일수와 기준 시각(승인 timestamp 등)은 무엇인지
14일 TTL은 getPayment 복구용 캐시만 해당하는지, 취소 API와는 무관한지
캐시가 만료된 뒤에도 승인번호·승인 시각 등을 직접 넘기면 requestPaymentCancel이 가능한지, 불가능하다면 VAN·카드사 쪽 제한을 어디서 확인하면 되는지
관리자 화면 등에서 환불 UI 노출 기간을 설계할 때 참고할 공식 가이드가 있는지
답변 주시면 플러그인 환불 목록 보관 정책과 안내 문구를 문서에 맞게 정리하겠습니다.

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

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

14일은 승인·취소 결과를 단말기에서 다시 조회할 수 있는 기간이지, 환불 기한이 아닙니다. 단말기에는 성공 결과만 최대 1,000건까지 저장됩니다.

캐시가 만료된 뒤에도 원승인번호·승인 시각·결제수단·금액 등 취소에 필요한 값을 보관하고 있다면 전액 취소를 요청할 수 있습니다. 다만 취소 요청이 가능하다는 것과 실제로 승인된다는 것은 별개입니다. 공개 SDK 가이드에는 승인 시각부터 계산하는 공통 취소 기한이나 환불 목록의 권장 노출 기간이 없습니다. 환불 목록은 단말 캐시와 별도로 관리해 주세요.

실제 취소 가능 기간은 결제수단마다 다를 수 있으며, 해당 거래의 VAN사·카드사 정책에 따릅니다. 특정 거래의 취소 기한을 확인하려면 이용 중인 VAN사 또는 VAN 대리점에 문의해 주세요.

결제·취소 API 가이드 · 단말 조회 결과와 실제 거래 상태의 차이를 안내한 기존 답변