1. APP to APP 요청 파라미터

호출 scheme : apppos://pay
( O : 필수 , △ : 사용가능 )

호출 scheme Parameter 설명 신용카드/앱카드/네이버페이 승인 현금 영수증 승인 현금IC 승인 OCR 승인 NFC 승인 신용카드/앱카드/네이버페이 취소 현금 영수증 취소 현금IC 취소 OCR 취소 거래 조회 비고
결제 Parameter gubun 거래구분자 O O O O O O O O O O 신용승인: 0100 / 신용취소: 0400
현금영수증승인: 0200 / 현금영수증취소: 0500
paypro승인 : 0300 / paypro취소 : 0600
거래조회 : 0700
현금IC승인 : 1000 / 현금IC취소 : 1100
OCR승인 : 1600 / OCR취소 : 1700
원큐페이 승인 : 1800 / 취소 : 1900
삼성NFC 승인 : 2000 / 취소 : 2100
할인신용승인 : 2300 / 신용취소는 동일
할인OCR승인 : 2500 / OCR취소는 동일
결제 Parameter price 금액 O O O O O O O O O O ,를 제외한 숫자만 입력 가능, 1억 이상 실패
결제 Parameter taxAmount 부가세 △ △ △ △ △ △ △ △ △ X 부가세 param 올릴경우 (0원도 포함)
APP 내 셋팅값 무시, 올린 값 우선 적용
결제 Parameter serviceAmount 봉사료 △ △ △ △ △ △ △ △ △ X 봉사료 param 올릴경우 (0원도 포함)
APP 내 셋팅값 무시, 올린 값 우선 적용
결제 Parameter taxfreeAmount 면세금액 △ △ △ △ △ △ △ △ △ X 신면세과세용 면세금액 사용 시
merchantReserved1 사용 못함
결제 Parameter oid 전문일련번호 △ △ △ △ △ - - - - O * 10byte (자리수 필수 확인) 조회시 사용 (CATID + oid) (일별 유니크한 값으로 셋팅) 승인요청만 적용, 취소는 임의로 생성됨
결제 Parameter catid VAN가맹점 id O O O O O O O O O O 가맹점 다운로드용 CATID
결제 Parameter appNo 원거래 승인번호 X X X X X O O O O X 취소시 사용 알리, 위챗페이 무거래 취소시 승인 시 응 답받은 NICE일련번호(20자리)를 승인번호 로 올림
결제 Parameter appDt 원거래 승인일시 X X X X X O O O O X 취소 시 원거래 일자(yymmdd)
조회 시 거래 일자(yymmdd)
결제 Parameter bizno 가맹점 사업자번호 O O O O O O O O O O 가맹점 다운로드용
사업자번호
결제 Parameter intMon 할부개월수 △ △ - △ △ - △ - △ - 신용/OCR 승인시에만 전송 (2 자리 숫자)
00, 01 : 일시불 , 값이 없으면 일시불
02 : 2 개월 ~ MAX : 12 개월
예) intMon=02
5 만원 초과 일 경우에만 (5 만원 미포함)
현금 IC 는 모두 일시불거래 00 셋팅
현금영수증 무거래 취소 시 할부 구분
추가 (소비자: 01 사업자: 02)
현금영수증 customerNo 사용시 할부개월
필수입력(01:소비자, 02:사업자)
결제 Parameter activityFinish 액티비티 종료 옵션 △ △ △ △ △ △ △ △ △ △ 가맹점앱이 웹뷰인경우 H/W back 버튼에 대한 이슈로 인해 생성
옵션 사용 : activityFinish = true
결제 Parameter returnURI 리턴 받을 가맹점 APP scheme O O O O O O O O O O scheme 뒤에 응답 파라미터 추가되어 리턴
가맹점에서 확인해야 할 주문번호가 있는 경우 scheme에 포함
(예: testapp://result?oid=123456)
가맹점 영역 Parameter merchantReserved1 가맹점 영역 1 △ △ △ △ △ X X X X X 실시간실적전송 필드 (신용/현금영수증)
* 가맹점 생성주문번호 사용가능
( “APP” + “주문번호 15byte”)
* 제휴카드 사용시 사용 (특정가맹점)
국민행복 : “CUV” + 11 byte
taxfreeAmount 필드 사용시 사용불가
가맹점 영역 Parameter merchantReserved2 가맹점 영역 2 △ △ △ △ △ △ △ △ △ △ 가맹점에서 돌려받기를 원하는 값으로 셋팅
앱에서만 돌려받는 필드
별도 Parameter appCatid 승인 VAN가맹점 id (catid) △ △ △ △ △ △ △ △ △ △ 승인용 CATID 다중사업자만 설정, 단독사업자는 param 안올림
별도 Parameter printOff 프린터 사용 옵션 △ △ △ △ △ △ △ △ △ X NM-1000 단말 사용자를 위해 추가,
프린터 미사용: printOff=true
별도 Parameter noCheckCancel 취소거래 체크 SKIP X X X X X △ △ △ △ X noCheckCancel=true 취소 거래시 기존 거래건 있는지 확인 로직을 SKIP하도록 처리
별도 Parameter niceSerialNo 나이스 일련번호 사용 △ X X X X △ X X X △ niceSerialNo=true 설정 시 NICE거래일련번호 리턴 신용카드 승인시에만 가능 알리, 위챗페이 거래시 필수 옵션
별도 Parameter cardNoView 카드번호 뒷 4자리 표출 △ X △ ? ? △ X △ ? △ cardNoView=true 일반 : 카드 bin (앞 6자리만) 표기 옵션 : 카드 bin + 뒤 4자리 표기 (15자리 카드는 뒤 3자리)
별도 Parameter noSign 서명 SKIP △ X X X X △ X X X X noSign=true 서명정보는 가맹점 앱에서 별도 처리하는 경우에만 사용 OCR결제 시 서명은 필수
별도 Parameter noReceipt 영수증화면 SKIP △ △ △ △ △ △ △ △ △ X noReceipt=true 간략결제결과 화면 & 영수증 선택화면 SKIP처리
별도 Parameter apprType 결제타입 △ X X △ △ △ X X △ △ apprType=true 설정 시 응답 전문 apprType에 값이 내려 옴 (신용 승인/취소시 에만 가능)
별도 Parameter notiNo 실적전송 번호 △ △ X △ △ △ △ X △ X notiNo=NOTI1234567890… (max 30byte) 가맹점 설정 실적전송용 번호
별도 Parameter cashSimplify 현금IC간소화 여부 X X △ X X X X X X X 현금IC결제 요청시 해당 거래건이 간소화 거래인 경우 가맹점에서 체크해서 올림 cashSimplify=true
별도 Parameter overseaCup 해외은련카드 여부 △ X X X X △ X X X X 해외은련카드 체크 시 비번입력 활성화 overseaCup=true
별도 Parameter selfIssue 자진발급 여부 X △ X X X X △ X X X self issue임, 현금영수증에서만 가능 selfIssue=true
별도 Parameter customerNo 고객식별 번호 X △ X X X X △ X X X 고객식별번호를 지정가능 (현금영수증) 13자리 이하인 경우만 처리 자진발급 미선택시 만 사용 (자진발급 선 택 시 해제처리 후 식별번호 우선처리) 할부개월 필수 입력(01:소비자, 02:사업자)
별도 Parameter giftCardNo 상품권번호 O X X X X O X X X X 가맹점 APP에서 상품권번호를 SCAN하는 경우 사용함 gubun 필드는 앱카드로 세팅 12 (승인:0300, 취소:0600) 잔액조회 시(금액 1원, 승인 : 0300)
별도 Parameter giftCardPin 상품권PIN O X X X X X X X X X 상품권 승인시 PIN번호 입력 상품권 취소 시에는 PIN번호 없음
별도 Parameter cupDeposit 컵보증금 △ △ △ △ △ △ △ △ △ X ,를 제외한 숫자(신용, 앱카드, 현금영수 증) 승인시에만 올림(취소시에는 올리지 않음)
별도 Parameter discountPrice 할인금액 △ X X X X X X X X X 리더기를 이용하는 신용카드 승인의 경우 할인금액 세팅, OCR도 포함 (10000원 원금액, 할인금액 2000원이면 price=8000&discountPrice=2000 세팅
별도 Parameter connectNo 연결번호 △ X X X X X X X X X 카드빈 1tran 체크를 사용하는 경우만 사용
(리더기/OCR카드빈 체크 시 내려감)