가이드/기타 연동 케이스/결제 결과 안내
목차

Version 2

새로 나온

결제 승인이 완료된 이후 구매자에게 결제 결과를 안내하는 방법입니다. 결제 이메일, 매출전표, 현금영수증을 확인하는 방법입니다.

이메일

토스페이먼츠 이메일

구매자에게 결제 변경사항을 이메일로 안내하려면 requestPayment() 메서드에 아래 파라미터를 설정하세요. 결제 승인, 결제 부분 취소, 결제 취소할 때 토스페이먼츠에서 위와 같은 안내 메일을 구매자에게 발송합니다.

파라미터

  • customerEmail string

    구매자의 이메일 주소입니다. 결제 상태가 바뀌면 이메일 주소로 결제내역이 전송됩니다. 최대 길이는 100자입니다.

  • customerName string

    구매자명입니다. 최대 길이는 100자입니다. 이메일에 구매자명이 추가돼요. 설정하지 않으면 기본적으로 '고객님'으로 이메일이 발송됩니다.

가상계좌

토스페이먼츠 가상계좌 알림

가 발급되면 이메일과 문자로 결제금액, 입금은행, 가상계좌번호, 예금주명, 입금기한 등 결제 정보가 구매자에게 전달됩니다. 구매자가 입금을 완료했을 때도 이메일, 문자로 입금 완료 안내가 발송되고요.

가상계좌의 예금주명은 상점명으로 설정돼요. 문자 발신 번호는 상점관리자 > 회사 정보 > 서비스별 정보 > 홈페이지 정보의 연락처입니다. 만약에 예금주명이나 발신 번호를 바꾸고 싶다면 상점관리자에서 설정을 변경해주세요.

개발 연동 체험 상점의 테스트 키를 사용하고 있다면, 가상계좌 안내 문자가 발송되지 않아요. 토스페이먼츠 전자결제 계약 이후에 확인할 수 있는 테스트 키로는 가상계좌 안내 문자가 발송됩니다.

매출전표

토스페이먼츠 매출전표

모든 신용・체크카드 결제에는 토스페이먼츠 가 생성됩니다. 결제 승인 이후에 Payment 객체의 receipt.url에서 매출전표 링크를 확인할 수 있어요. 구매자에게 해당 링크를 보여주거나 필요에 따라 자유롭게 사용하세요. 테스트 환경에서는 실제 매출전표 데이터가 제공되지 않습니다. 라이브 환경에서 확인하세요.

상점관리자 > 결제조회 메뉴의 '영수증' 칼럼에서 동일한 매출전표를 확인할 수 있습니다.

현금영수증

토스페이먼츠 현금영수증

가맹점으로 가입된 사업자는 반드시 현금영수증을 발행할 의무가 있습니다. 현금영수증은 국세청에서 발급하지만, 사업자가 직접 모든 거래 건을 신고하기 어렵기 때문에 토스페이먼츠를 통해 현금영수증 발급을 대행할 수 있어요. 토스페이먼츠에서 결제된 거래는 물론, 결제하지 않은 거래도 토스페이먼츠를 통해 현금영수증을 발급할 수 있어요.

발급된 현금영수증은 링크를 구매자에게 보내거나 필요에 따라 자유롭게 사용하세요. 테스트 환경에서는 실제 현금영수증 데이터가 제공되지 않습니다. 라이브 환경에서 확인하세요.

  • 현금영수증 발급 상태

    현금영수증 발급 신청 직후에는 '국세청 발급요청' 상태입니다. 토스페이먼츠에서 수집한 현금영수증 데이터는 다음날 일괄로 국세청에 발급을 요청해요. 그렇기 때문에 현금영수증 발급 신청 다음날 오후에 현금영수증이 '발급완료' 상태로 변경되고 홈택스에서 확인할 수 있어요.

  • 토스페이먼츠에서 결제된 거래

    결제 승인 이후 받는 Payment 객체의 cashReceipt.receiptUrl 필드에서 확인할 수 있어요. 토스페이먼츠에서 결제를 취소 또는 부분취소하면 자동으로 현금영수증도 취소, 부분취소됩니다.

  • 토스페이먼츠에서 결제하지 않은 거래

    현금영수증 발급 요청 API를 사용하세요. API 응답으로 돌아오는 CashReceipt 객체의 receiptUrl 필드에서 현금영수증을 확인할 수 있어요. 현금영수증 발급 요청 API로 발행된 현금영수증은 토스페이먼츠에서 원거래를 알 수 없기 때문에 취소, 부분취소가 발생하면 직접 API를 통해서 현금영수증도 취소해주세요.

  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    실시간 문의|이메일 보내기