EC 시스템의 결제 내역과 PG사(이니시스)의 승인 내역 간의 대사를 수행합니다. 주요 기능으로는 PG승인대사 및 PG정산대사가 있으며, 이를 통해 금액 불일치 시 조정 및 입금 확정/취소 처리가 가능합니다.
...
API | 설명 | Server | 메소드 | 비고 |
|---|---|---|---|---|
PG승인대사 요약조회 | PG승인대사 목록에 대한 요약 건수 및 합계를 조회합니다. | BO | POST | |
PG승인대사 목록조회 | PG승인대사 목록을 조회합니다. | BO | POST | |
PG승인정보 수신 | 특정 날짜, PG사에 대한 PG 승인 목록을 수신합니다. | BO | POST | PG승인대사목록 수신 - /api/common/v1/adjust/pgCompare/receivePgApprovalList |
PG승인대사 불일치사유 저장 | PG 승인 건과 EC 결제 건의 대사 불일치 사유를 저장합니다. | BO | POST | |
PG승인대사목록 수신 | 특정 날짜, PG사에 대한 PG 승인 목록을 PG사 인터페이스를 통해 수신합니다. | Common | POST | *API 확인 안됨 |
API 기능 목록_PG정산대사
API | 설명 | Server | 메소드 | 비고 |
|---|---|---|---|---|
PG정산대사 요약 조회 | PG정산대사 목록에 대한 요약정보를 조회합니다. | BO | POST | |
PG정산대사 목록 조회 | PG정산대사 목록을 조회합니다. | BO | POST | |
PG정산대사 조정사유 저장 | 입금금액이 불일치하는 건에 대해 금액을 조정하고 사유를 저장합니다. | BO | POST | |
PG정산정보 수신 | 특정 날짜, PG사에 대한 PG 정산 목록을 수신합니다. | BO | POST | |
PG정산대사 입금확정/입금확정 취소 처리 | 입금금액이 일치하는 건에 대해 입금을 확정 처리하거나 입금확정에 대한 취소처리를 합니다. | BO | POST | |
PG 정산대사목록 수신 | 특정 날짜, PG사에 대한 PG 정산 목록을 PG사 인터페이스를 통해 수신합니다. | Common | POST |
...
현재 이니시스 mid는 개인으로 발급받지 않고 공용 mid를 사용하고 있어 모든 테스트 데이터가 넘어오기 때문에 X2BEE 주문만 구별해주기 위해 승인대사, 정산대사 저장 시 X2BEE 주문 정규식 패턴에 맞는 주문번호만 저장하고 있다.
Pattern.compile("^\\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\\d|3[01])O\\d{6}$")
PG승인대사
Api-common 의 PG승인정보 수신 api 에서는 request 에 넘어온 PG사에 대해 application.yml 의 “pg.compare” 레벨로 등록 되어있는 mid 에 대한 승인 정보를 가져옵니다.
승인정보 수신 시 PG사 별 데이터 및 유효성 체크
이니시스(Inicis)
유효성체크: 넘어온 데이터가 0001(가맹점 서버에 등록되지 않은 IP 로 조회했을 경우), 0003(가맹점관리자 사이트에서 데이터 항목설정을 하지 않았을 경우) 으로 시작하 면 예외 처리
데이터: 모든 내역이 String 으로 넘어오기 때문에 승인 건 당 “<br>” 로 split 후 각 항목을 “|” 로 split 한다.
매입 전 취소 (당일취소) 일 때는 PG 승인목록에 결제승인 데이터가 존재하지 않아서 EC 시스템과 대사해주기 위해 승인 데이터를 직접 생성합니다.
PG정산대사
정산정보 수신 시 PG사 별 데이터 및 유효성 체크
이니시스(Inicis)
유효성체크: 넘어온 데이터의 Header 를 쪼갰을 때, 21번쨰 데이터(에러코드) 가 “02(잘못된 날짜형식), 03(mid 패스워드 오류), 04(IP권한오류), 99(알수없는 오류)” 이면 예외 처리
데이터: 모든 내역이 String 으로 넘어오기 때문에 승인 건 당 “<br>” 로 split 후 실제 데이터(B로 시작하는 row)를 추려서 각 항목을 “|” 로 split 한다.