토스페이 연동가이드
API 레퍼런스현금영수증 API

현금 영수증 팝업 주소 전달

토스 결제 가맹점을 이용한 고객이 현금영수증의 발급 및 취소된 것의 발급 이미지 등을 요구할 때, 해당 API를 호출하여 리턴되는 팝업 Uri 값으로 대응이 가능합니다.

각 API 응답 필드와 에러코드는 사전 공지 없이 추가되거나 변경될 수도 있으니, 추가된 항목으로 인해 오류가 발생하지 않도록 처리에 유의해 주시기 바랍니다.

POSThttps://pay.toss.im/api/v2/cash-receipt-popupUri

요청 파라미터

apiKeystring필수

결제 가맹점의 API Key. API Key는 LIVE 값만 동작하며 TEST 값은 무시됩니다.

최대 30자
payTokenstring필수

결제토큰

최대 30자

응답 파라미터

codeinteger (int32)

응답코드. 0: 성공, -1: 실패 (실패 사유는 msg와 errorCode로 제공)

errorCodestring

에러 코드

msgstring

응답이 성공이 아닌 경우 설명 메시지

popupUristring

팝빌이 제공하는 현금영수증 팝업 URI

요청 예제

응답 예제