API 명세서
현금 영수증 API
소개

토스 현금영수증 API 소개

본 문서는 토스페이 결제 가맹점에서 현금영수증을 발급하거나 취소, 상태 확인 및 현금영수증 이미지 주소를 얻고자 할 때 사용할 API에 대한 가이드를 제공합니다.

토스페이 결제 가맹점에서는 해당하는 현금영수증 API를 이용하여 국세청으로 현금영수증을 등록 및 취소, 상태 확인 등을 할 수 있습니다.

이를 위해 토스페이에서는 토스페이먼츠(PG)를 통해 가맹점에게 현금영수증 API를 제공하고,
토스페이먼츠(PG)를 통해 국세청으로 정상 등록이 되면 통상 2일 안에 국세청으로부터 동기화 과정을 거쳐서 현금영수증의 발급이 완료됩니다.

유의할 점

현금영수증 처리 완료 일시

  • 현금영수증 API 를 호출하더라도

    1. 국세청으로 전송
    2. 국세청에서 확인 후 승인 또는 거절 등의 단계를 거쳐 처리

과정을 거치므로 현금영수증 API 호출 후 통상 2 ~ 3 일의 시일이 지나야 국세청에 등록이 완료됩니다.

  • 현금영수증 취소의 경우, 환불 시 별도의 원장에 기록된 현금영수증 취소 STANDBY가 환불과 동시에 생성되며 뒷단 배치에서 해당 STANDBY를 읽어 현금영수증 취소 처리 후 토스페이먼츠(PG)로 취소 요청이 전달됩니다.