전문 안내
본 문서는 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 에 표기된 전문길이는 예시로서, 실제 입력시 전문구분과 전문내용의 길이를 입력해야 합니다.
- 서버(단말기)별 사용가능/불가능 전문이 있으니, 확인 후 적용 바랍니다.
- 서버(단말기)별 요청 파라미터가 상이할 수 있으니, 파라미터 확인 후 적용 바랍니다.