토스페이 연동가이드

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

엔드포인트

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

요청 파라미터

apiKeystring필수

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

payTokenstring필수

결제토큰

응답 파라미터

cashReceiptMgtKeystring

현금영수증 관리번호 값

customerNamestring

현금영수증 신청 고객명

itemNamestring

상품명

identityNumstring

고객 식별번호. 현금영수증 발급 당시 사용한 고객 식별번호 (예: 휴대폰번호, 사업자등록번호 등)

taxationTypestring

과세형태 (과세 / 비과세)

totalAmountstring

현금영수증 발급 총액

tradeUsagestring

발급 목적 (소득공제용 / 지출증빙용)

tradeTypestring

거래유형 (승인거래 / 취소거래)

statusstring

현금영수증 상태

가능한 값:

IN_PROGRESS국세청 전송중

ISSUE_APPLIED발급 신청 완료

ISSUE_COMPLETE발급 완료

ISSUE_FAILED발급 실패

tradeDatestring

등록 요청 날짜

confirmNumstring

발행승인번호

confirmTsstring

발행일시. ISO-8601 형식 (예: 2019-03-21T14:02:49)

예제

Example Request

{
  "apiKey": "example_api_key",
  "payToken": "example_payToken"
}

Example Response

{
  "cashReceiptMgtKey": "123456-123456",
  "customerName": "김토스",
  "itemName": "테스트 상품",
  "identityNum": "01012341234",
  "taxationType": "과세",
  "totalAmount": "10000",
  "tradeUsage": "소득공제용",
  "tradeType": "승인거래",
  "status": "ISSUE_APPLIED",
  "tradeDate": "20180512"
}

현금 영수증 상태 확인

엔드포인트

요청 파라미터

응답 파라미터

예제

목차