파일양식
•
NDJSON 포맷의 통보 결과 파일을 직접 전달
Parameter
•
subBusinessNumber 필수 String
최종 하위사업자 번호
•
orderId 필수 String
가맹점 주문번호
•
approvalDate 필수 String
원거래 승인 일자 yyyyMMdd
•
transactionDate 필수 String
거래일자 (승인일자 또는 취소일자 yyyyMMdd)
•
transactionType 필수 String
승인/취소 구분
APPROVE : 승인
CANCEL : 취소
JSON
복사
•
transactionId paymentKey(PX) 필수 String
PG거래번호 (Transaction ID)
•
originalAmount 필수 String
원거래 승인/취소 금액
•
transactionAmount 필수 String
최종 하위 사업자 매출액
•
smbType 필수 String
가맹점 영중소 등급
SMALL : 영세
MEDIUM_1 : 중소1 (3~5억원)
MEDIUM_2 : 중소2 (5~10억원)
MEDIUM_3 : 중소3 (10~30억원)
NORMAL : 일반
JSON
복사
•
useEscrow 필수 boolean
에스크로 사용 여부
false : 일반
true : 에스크로
JSON
복사
•
cardType 필수 String
카드 구분
CREDIT : 신용카드
CHECK : 체크카드
JSON
복사
•
merchantCustomField String
가맹점 예약 필드
•
applyCommissionRate 필수 String
환급 수수료율
•
applyVAT 필수 String
부가세
•
payoutDate 필수 String
정산 일자
•
payoutAmount 필수 String
정산금액(VAT 포함)
모든 금액은 절대값으로 전달됩니다.
transactionType(승인/취소)에 따라 계산(+/-)이 필요합니다
•
payoutResultCode 필수 String
정산 결과 코드
•
payoutResultMessage 필수 String
결과 메세지
전체 거래 내역 전달
{"subBusinessNumber":"7491402361","orderId":"P3EaUA2qx2nUlP0Kz2OZ9e","approvalDate":"20250106","transactionDate":"20250109","transactionType":"CANCEL","transactionId":"toss_202501061244198OiV3","partialCancelSequence":"143626013","originalAmount":"143626013","transactionAmount":"19490.00","smbType":"MEDIUM_1","useEscrow":false,"cardType":"CREDIT","merchantCustomField":"","applyCommissionRate":"01.10","payoutDate":"20250313","payoutAmount":"-214","payoutResultCode":"00","payoutResultMessage":""}
{"subBusinessNumber":"5238803018","orderId":"E4Awig7GpdgTkPM5en1a49","approvalDate":"20250105","transactionDate":"20250114","transactionType":"CANCEL","transactionId":"toss_2025010519553382l00","partialCancelSequence":"143747393","originalAmount":"143747393","transactionAmount":"6700.00","smbType":"MEDIUM_1","useEscrow":false,"cardType":"CREDIT","merchantCustomField":"","applyCommissionRate":"01.10","payoutDate":"20250331","payoutAmount":"-74","payoutResultCode":"00","payoutResultMessage":""}
...
JSON
복사
결과 코드
Code | Message | Description |
00 | SUCCESS | 정상 |
01 | DISCORD_CARD | 카드사별 구분값 오류(미존재 또는 불일치) |
02 | AMOUNT_SUM_ERROR | 매출금액 오류(원매출금액과 하위사업자 매출액 SUM의 불일치) |
03 | ALREADY_COMPLETED | 중복접수(기 처리된 내역을 전송) |
04 | REJECT_CAPTURE | 원매입 반송(원매출 미존재 또는 매출금액 오류 등) |
05 | DISCORD_CAPTURE | 매입취소구분 오류(원매출과 하위매출의 정상/취소 불일치) |
06 | CAPTURE_DATE_ERROR | 매입전송일자 오류 |
07 | AUTHORIZE_DATE_ERROR | 승인일자 오류 |
08 | AUTHORIZE_NUMBER_ERROR | 승인번호 오류(원승인번호에 해당하는 매출 미존재) |
09 | NOT_EXIST_MERCHANT_NUMBER | 가맹점번호 오류1(가맹점번호가 SPACE이거나 미등록가맹점) |
10 | NOT_TARGET_MERCHANT | 가맹점번호 오류2(환급정산 가맹점 번호가 아님) |
11 | CARD_NUMBER_ERROR | 카드번호 오류 |
12 | NOT_BUSINESS_TARGET | 중간하위사업자 오류(전자금융업자 미해당사업자 등) |
13 | DELAY_RECEIVED | 환급정산 지연접수 |
14 | RELATED_DISCORD_CARD | 카드사별 구분값 정상건 반송
(A,B,C로 구성된 장바구니 거래에서 C의 카드사별 구분값이 오류인 경우 C는 01번 코드로 회신하나, A,B는 카드사별 구분값이 정상임에도 C로 인해 반송되는 것이므로 14번 코드로 구별하여 회신) |
15 | ETC_ERROR | 기타 오류(관리자 문의) |
99 | ETC | 기타(관리자 문의) |
수정내역
•
2025-08-19: version 1.1 업데이트 - 부분취소키(partialCancelSequence) 추가