현금 영수증 발급
해당 결제가 status = PAY_COMPLETE으로 완료되었을 때, 현금 영수증 발급이 가능합니다.
각 API 응답 필드와 에러코드는 사전 공지 없이 추가되거나 변경될 수도 있으니, 추가된 항목으로 인해 오류가 발생하지 않도록 처리에 유의해 주시기 바랍니다.
주의 사항: 토스의 결제 금액과 현금영수증의 불일치를 막기 위해 발급 API에서는 금액 정보를 파라미터로 받지 않습니다. 이미 결제 처리가 되어 토스 시스템에 기록된 과세 항목, 비과세 항목 등의 값을 바탕으로 현금영수증 발급이 처리됩니다.
엔드포인트
요청 파라미터
결제 가맹점의 API Key
API Key는 LIVE 값만 동작하며 TEST 값은 무시됩니다.
결제 토큰
현금영수증 발급 대상 결제는 결제 완료(status = PAY_COMPLETE) 상태여야 합니다.
발급 주체를 식별할 수 있는 key 값
ex) 개인의 경우 - 휴대폰번호, 사업장의 경우 - 사업자등록번호
현금영수증 keyType
현금영수증 keyType
| 값 | 설명 |
|---|---|
| PHONE | 전화번호 |
| CORPORATE | 사업자등록번호 |
| CARD | 카드번호 |
현금영수증 발급 목적
현금영수증 발급 목적
| 값 | 설명 |
|---|---|
| DEDUCTION | 소득공제용 |
| EVIDENCE | 지출증빙용 |
자진발급 처리 여부
자진발급 처리를 희망하지 않을 경우, needSelfIssue 파라미터는 전달하지 않습니다. (기본값 false)
자진발급 처리 여부를 true로 전달할 경우, 자진발급 처리를 진행할 수 있습니다.
토스 유저의 현재 현금영수증 식별번호로 발급 처리 여부
해당 값을 true로 전달할 경우 식별번호를 보내지 않아도 토스가 저장하고 있는 유저의 현재 현금영수증 식별 번호로 발급 처리됩니다. (기본값 false)
Example Request
{
"apiKey": "example_api_key",
"payToken": "example_payToken",
"cashReceiptKey": "01001230123",
"cashReceiptKeyType": "PHONE",
"cashReceiptPurpose": "DEDUCTION"
}응답 파라미터
http status code
응답 코드
0: 정상, 그 외 값은 에러
관리번호 값
발급 요청된 현금영수증을 확인할 수 있는 관리번호 값
공급가액
공급가액 = 과세 금액 + 비과세 금액 supplyCost = amountTaxable + amountTaxFree
부가세
부가세 tax = amountVat
봉사료
봉사료 serviceFee = amountServiceFee
Example Response
{
"status": 200,
"code": 0,
"cashReceiptMgtKey": "123456-123456",
"supplyCost": 909,
"tax": 91,
"serviceFee": 0
}