별도 parameter 사용시 주의사항
- 다중사업자의 경우 appCatid를 별도로 추가하며, appCatid 로 승인이 이루어 진다.
- 별도의 계약으로 사전협의 및 내부 설정이 완료되어야 사용 가능
연동 시 가맹점 앱에서 처리할 사항
- AndroidManifest.xml 에서 결제완료 후 호출될 수 있는 app scheme 설정필요
- iOS의 경우 app scheme를 APP-POS 와 가맹점APP 두 곳 모두에 설정을 해야 서로 호출이 가능함 (별도 요청 필요)
- APP to APP 연동의 경우 APP-POS가 결제중간 에러가 나는 경우 결과회신이 불가능하기 때문에 해당 부분을 보완하기 위해 “실시간 실적전송”
연동 필요
- 거래불일치 (가맹점은 미승인, VAN은 승인) 상황에서 거래 일치를 위해 거래조회 추가
- “실시간실적전송”을 위해서는 가맹점과 NICE간 방화벽 open 필요
-
연동 예시
- 가맹점 서버에서 주문번호, 일련번호 생성
- 일련번호는 전문별 일련번호로, 승인 시에만 oid에 사용 (취소 시에는 mmdd24mihhss로 APP-POS에서 자체 생성)
- 주문번호는 merchantReserved1에 사용
- 가맹점 앱에서 서버에서 생성된 정보를 APP-POS 호출
- APP-POS에서 결제 완료 후 return이 정상적으로 일어나게 되면, 가맹점 앱에서 해당 거래건을 서버로 조회하여 실적 전송 수신 여부 확인
- APP-POS에서 결제가 정상적으로 안 되고 죽은 경우, 가맹점 앱에서 해당 거래건을 서버로 조회하여 실적 전송 수신 여부 확인
- 망취소가 필요한 경우, 서버에서 승인 CATID (appCatid) + 일련번호로 20자리 만들어서 송신
APP to APP 연동 보완사항
- 실시간 실적전송
- 실시간 실적전송은 VAN에서 거래가 난 건에 대해 server to server로 socket을 사용하여 전송해주는 방식이며, 전문은 별도로 제공
- 신용카드번호는 앞 6자리를 제외한 나머지 번호가 * 처리되어 전송 (자체 매입 진행 시 전체 자리수 제공 가능, 제3자 제공은 불가)
- merchantReserved 안에 셋팅한 값이 전송 가능 (주문번호 사용 가능)
- 가맹점별로 협의하여 암호화 및 재시도 여부 설정 가능, 원장 내의 data 추가 가능
- 전문망취소
- 일반적인 망취소가 아닌 결제정보 없이 취소가 가능한 취소방식임
- 고객에게 다시 카드를 받을 필요 없이, 전문 일련번호로만 취소가 가능
- 승인건에 대한 취소만 가능, 취소에 대한 취소는 없음
- 전문 포맷 및 샘플 제공 가능
- 조회 후 취소 (망취소 대체 취소)
- 조회 기능 사용으로 인하여 기존의 망취소 대신 조회 후 승인내역을 받아서 취소를 해야 한다.
지원 단말 (오디오잭 리더기 MSM-2000 사용시)
- 지원 단말표 별도 제공
- 블루투스 리더기의 경우 BLE지원 휴대폰은 모두 가능
CATID설정 관련
- APP-POS를 APP to APP으로 연동시 다중사업자 연동이라면 CATID설정을 본사/대리점 직원에게 문의하여 CATID를 새로 발급 받아야 한다.
Apppos 문의사항 접수
- 각 가맹점에서 컨택하는 대리점, 혹은 NICE정보통신 영업팀 직원을 통해 문의