별도 parameter 사용시 주의사항

  • 다중사업자의 경우 appCatid를 별도로 추가하며, appCatid 로 승인이 이루어 진다.
  • 별도의 계약으로 사전협의 및 내부 설정이 완료되어야 사용 가능

연동 시 가맹점 앱에서 처리할 사항

  • AndroidManifest.xml 에서 결제완료 후 호출될 수 있는 app scheme 설정필요
  • iOS의 경우 app scheme를 APP-POS 와 가맹점APP 두 곳 모두에 설정을 해야 서로 호출이 가능함 (별도 요청 필요)
  • APP to APP 연동의 경우 APP-POS가 결제중간 에러가 나는 경우 결과회신이 불가능하기 때문에 해당 부분을 보완하기 위해 “실시간 실적전송” 연동 필요
  • 거래불일치 (가맹점은 미승인, VAN은 승인) 상황에서 거래 일치를 위해 거래조회 추가
  • “실시간실적전송”을 위해서는 가맹점과 NICE간 방화벽 open 필요
  • 연동 예시

    1. 가맹점 서버에서 주문번호, 일련번호 생성
      • 일련번호는 전문별 일련번호로, 승인 시에만 oid에 사용 (취소 시에는 mmdd24mihhss로 APP-POS에서 자체 생성)
      • 주문번호는 merchantReserved1에 사용
    2. 가맹점 앱에서 서버에서 생성된 정보를 APP-POS 호출
    3. APP-POS에서 결제 완료 후 return이 정상적으로 일어나게 되면, 가맹점 앱에서 해당 거래건을 서버로 조회하여 실적 전송 수신 여부 확인
    4. APP-POS에서 결제가 정상적으로 안 되고 죽은 경우, 가맹점 앱에서 해당 거래건을 서버로 조회하여 실적 전송 수신 여부 확인
    5. 망취소가 필요한 경우, 서버에서 승인 CATID (appCatid) + 일련번호로 20자리 만들어서 송신

APP to APP 연동 보완사항

  1. 실시간 실적전송
    • 실시간 실적전송은 VAN에서 거래가 난 건에 대해 server to server로 socket을 사용하여 전송해주는 방식이며, 전문은 별도로 제공
    • 신용카드번호는 앞 6자리를 제외한 나머지 번호가 * 처리되어 전송 (자체 매입 진행 시 전체 자리수 제공 가능, 제3자 제공은 불가)
    • merchantReserved 안에 셋팅한 값이 전송 가능 (주문번호 사용 가능)
    • 가맹점별로 협의하여 암호화 및 재시도 여부 설정 가능, 원장 내의 data 추가 가능
  2. 전문망취소
    • 일반적인 망취소가 아닌 결제정보 없이 취소가 가능한 취소방식임
    • 고객에게 다시 카드를 받을 필요 없이, 전문 일련번호로만 취소가 가능
    • 승인건에 대한 취소만 가능, 취소에 대한 취소는 없음
    • 전문 포맷 및 샘플 제공 가능
  3. 조회 후 취소 (망취소 대체 취소)
    • 조회 기능 사용으로 인하여 기존의 망취소 대신 조회 후 승인내역을 받아서 취소를 해야 한다.

지원 단말 (오디오잭 리더기 MSM-2000 사용시)

  • 지원 단말표 별도 제공
  • 블루투스 리더기의 경우 BLE지원 휴대폰은 모두 가능

CATID설정 관련

  • APP-POS를 APP to APP으로 연동시 다중사업자 연동이라면 CATID설정을 본사/대리점 직원에게 문의하여 CATID를 새로 발급 받아야 한다.

Apppos 문의사항 접수

  • 각 가맹점에서 컨택하는 대리점, 혹은 NICE정보통신 영업팀 직원을 통해 문의