전문 안내

본 문서는 EximPay 앱과 타사앱간 연동을 통해 EximPay 앱이 결제 전문등을 대리 수행 할 수 있도록 하는 API 를 제공합니다.

전문 구성


[Header]

      (1). 전문길이
          -> type: number
          -> length: 4
          -> desc: 전문길이 <전문번호 + 전문내용> - 메시지 수신시 해당 크기만큼의 byte array 데이터를 처리

      (2). 전문번호
          -> type: number
          -> length: 6
          -> desc: 전문 타입별 고유의 번호로 전문을 구분함


[Body]

      (3). 전문내용
          -> type: object
          -> length: N/A
          -> desc: 전문 타입별 고유의 번호로 전문을 구분함

전문의 형태


  
  (1)전문길이 + (2)전문번호 + (3)전문내용

                    

전문 예시

                      
                        
case1. 신용승인(010010) 요청시 전문번호 + 전문내용의 길이가 100 인 경우
    > 0100010010{"priceAmt":"5000", "taxAmt":"455", ...}

case2. 신용취소(010020) 요청시 전문번호 + 전문내용의 길이가 250 인 경우
    > 0250010020{"approvalAmt":"5000", "approvalNo":"27146335", ...}
    
case3. 직전거래조회(990001) 요청시 (전문 내용 불필요)
    > 0006990001

전문 처리 방법


[Receive]

      1. 연결된 소켓을 통해 전달받은 message(InputStream) 로부터 첫 4byte 만큼의 데이터를 확인 - 전문길이
      2. 전문 길이만큼의 데이터를 읽어낸 후, 6byte 만큼의 데이터를 확인 - 전문번호
      3. 나머지 Json 형태의 전문내용을 파싱


[Send]

      (*전문의 형태 참고) 전문의 형태를 갖춘채로 연결된 socket 으로 send message

                    

공통사항



 - 응답 결과 성공시 <resultCode = 0000>

                    

Tips


- 전문구분의 Payload 정보는 전문내용(Body) 에 해당하는 정보 입니다.
- 전문구분별 Payload, Header 를 참고 후 Header+Payload 결과를 send/receive 하세요.
- 각 Header 의 Example 에 표기된 전문길이는 예시로서, 실제 입력시 전문구분과 전문내용의 길이를 입력해야 합니다.
- 서버(단말기)별 사용가능/불가능 전문이 있으니, 확인 후 적용 바랍니다.
- 서버(단말기)별 요청 파라미터가 상이할 수 있으니, 파라미터 확인 후 적용 바랍니다.