2. APP to APP 응답 파라미터

scheme: 요청returnURI App scheme
( O : 필수 , △ : 사용가능 )

호출 scheme Parameter 설명 신용카드/앱카드/네이버페이 승인 현금 영수증 승인 현금IC 승인 OCR 승인 NFC 승인 신용카드/앱카드/네이버페이 취소 현금 영수증 취소 현금IC 취소 OCR 취소 거래 조회 비고
결제 Parameter gubun 거래구분자 O O O O O O O O O O 응답 전문 코드 신용승인 : 0101 / 신용취소 : 0401 현금영수증승인 : 0201 / 현금영수증취 소 : 0501 paypro승인 : 0301 / paypro취소 : 0601 거래조회응답 : 0701 현금IC승인 : 1001 / 현금IC취소 : 1101 OCR승인 : 1601 / OCR취소 : 1701 원큐페이 승인 : 1801 / 취소 : 1901 삼성NFC 승인 : 2001 / 취소 : 2101
결제 Parameter oid 거래일련번호 O O O O O △ △ △ △ O 승인시 설정한 전문일련번호 (10byte)
결제 Parameter resultCode 결과코드 O O O O O O O O O O 성공: 0000, 그 외는 실패 APP-POS APP 세부 에러코드 참조
(7979: 해당가맹점 아님)
결제 Parameter appNo 승인번호 O O O O O O O O O O 취소시는 취소요청시 올린 승인번호
실패시 미전송
위챗페이 승인번호 20자리
결제 Parameter appPrice 금액 O O O O O O O O O O 요청금액과 승인금액 비교로직
가맹점 앱내에서 확인 필요
취소응답시는 취소금액
실패시 미전송
금액 = 승인금액+부가세+봉사료
결제 Parameter taxAmount 부가세 △ △ △ △ △ △ △ △ △ X 승인시 처리된 부가세
결제 Parameter serviceAmount 봉사료 △ △ △ △ △ △ △ △ △ X 승인시 처리된 봉사료
결제 Parameter taxfreeAmount 면세금액 △ △ △ △ △ △ △ △ △ X 승인시 처리된 면세
결제 Parameter appDt 승인일시 O O O O O O O O O O yymmddhh24miss
취소시는 원거래승인일시
조회시는 거래일시 (올린값)
실패시 미전송
현금IC 승인일시(yymmddHHmm00)
결제 Parameter cancelDt 취소일시 X X X X X O O O O O yymmdd
조회시는 취소일시
실패시 미전송
결제 Parameter cardNo 카드번호 O O O O O O O O O O 앞 6 자리외 마스킹
실패시 미전송
selfCardApp 에 등록된 자사카드
결제요청 시 자사카드번호는 마스킹 X
결제 Parameter accountNo 계좌번호 X X O X X X X O X X 현금 IC 승인/취소 일 경우만 처리
결제 Parameter issuerCd 발급사코드 O O O O O O O O O O 첨부된 카드코드집 확인 실패시 미전송
결제 Parameter acquirerCd 매입사코드 O O O O O O O O O O 첨부된 카드코드집 확인 실패시 미전송
결제 Parameter intMon 할부개월수 O △ X △ △ O △ X △ X 신용응답, 현금영수증 전송 (2자리 숫 자)
00, 01: 일시불, 값이 없으면 일시불 02: 2개월 ~ MAX: 12개월
예) intMon=02
5만원 초과 일 경우에만 (5만원 미포 함)
현금IC결제인 경우
00: 일반결제
01: 간소화결제
현금영수증인 경우
01: 자진발급, 소비자
02: 사업자
결제 Parameter pointTotal 잔액 O X X X X O X X X X 잔액이 있는 선불카드의 경우
결제 Parameter hash Hash 검증 값 O O O O O X X X X X sha256(gubun + resultCode + appNo + appPrice + appDt)
가맹점Hash검증 값 실패시 미전송
가맹점 영역 Parameter merchantReserved1 가맹점 영역 1 O O O O O O O O O O * 주문번호 사용가능 ( “APP” + “주문번호 15byte”)
실시간실적전송 가능 필드
가맹점 영역 Parameter merchantReserved2 가맹점 영역 2 O O O O O O O O O O 가맹점에서 돌려받기를 원하는 값으로 셋팅
앱에서만 돌려받는 필드
별도 Parameter appCatid 승인 VAN가맹점 id (catid) O O O O O O O O O O 승인된 CATID
별도 Parameter niceSerialNo 나이스거래 일련번호 O O X △ △ O O X △ O 나이스 거래일련번호 옵션 셋팅 시 응 답
현금IC일 경우 *된 계좌번호 응답
알리, 위챗페이 거래시 필수옵션 유니 크한 NICE일련번호(20자리)를 승인번호 로 응답
카카오페이, 머니의 경우 공백
별도 Parameter apprType 결제타입 O X X O O O X X O O 요청 전문 apprType 셋팅할 경우만 IC: I ,MSR: M ,KEYIN: K,FALLBACK: F 삼성페이: SPAY ,LG페이: LPAY 카카오페이: KPAY ,카카오머니: KMNY 국내은련: c (소문자), 해외은련: C (대문 자), 위챗페이:WC, 알리페이: ALI, ABC마 트상품권: ABC 네이버페이: 포인트 PV, 네이버페이 신용/체크카드: PC, BC페이 북: PB BC가맹점 자체앱: PA 서울페이:SP, 원큐페이:OQ, 그 외 앱카 드: TF
별도 Parameter selfIssue 자진발급 여부 X O X X X X O X X X self issue 임 , 현금영수증에서만 가능 selfIssue=true
별도 Parameter integMembership 통합멤버쉽 △ X X X X △ X X X △ [카카오페이일 경우에만 사용] 카카오 통합멤버쉽 번호
조회 시 카카오페이(카드)인 경우 응답
별도 Parameter mercMembership 가맹점 멤버쉽 △ X X X X △ X X X △ [카카오페이일 경우에만 사용] 가맹점 멤버쉽 번호
조회 시 카카오페이(카드)인 경우 응답
별도 Parameter discountPrice 할인금액 △ X X X X △ X X X △ [카카오페이일 경우에만 사용] 카카오 자체 할인금액
조회 시 카카오페이(카드)인 경우 응답
별도 Parameter realAppPrice 실승인금액 △ X X X X △ X X X △ [카카오페이일 경우에만 사용] 전체금액 - 할인금액, 실제 승인금액
조회 시 카카오페이(카드)인 경우 응답
별도 Parameter cupDeposit 컵보증금 △ △ △ △ △ △ △ △ △ X 승인 시 요청 전문에서 올리는 cupDeposit 값을 그대로 응답 전문에 내려줌(취소거래시 응답없음)