PG승인정산대사
- Former user (Deleted)
- X2BEE 관리자
EC 시스템의 결제 내역과 PG사(이니시스)의 승인 내역 간의 대사를 수행합니다. 주요 기능으로는 PG승인대사 및 PG정산대사가 있으며, 이를 통해 금액 불일치 시 조정 및 입금 확정/취소 처리가 가능합니다.
주요 기능
PG승인대사
EC 결제금액과 PG 거래금액이 동일한 건에 대해 정산대사를 진행합니다.
수수료를 고려한 입금금액이 EC 입금 예정액과 일치하지 않을 경우 기타조정금액을 조정합니다.
입금확정 및 확정취소 처리가 가능합니다.
PG 정산정보 수신 시 자동으로 입금확정 처리를 진행합니다.
PG정산대사
PG승인목록 중 EC 결제금액과 PG 거래금액이 동일한 건에 대해 정산대사를 진행합니다.
수수료를 고려한 입금금액이 EC 입금 예정액과 일치하지 않을 경우 기타조정금액을 조정합니다.
입금확정 및 확정취소 처리가 가능합니다.
PG 정산정보 수신 시 자동으로 입금확정 처리를 진행합니다.
프로세스 정의
사이트의 결제/취소 내역과 PG사의 승인/승인취소 내역을 대사 합니다.
승인 시 금액이 일치하는 건에 대해 입금정보와 정산정보를 대사 합니다.
구분 | 설명 | |
|---|---|---|
| 1 | PG승인대사 요약 조회 | 선택한 조회조건에 대한 요약 정보를 조회합니다.
|
| 2 | PG승인대사 목록 조회 | 선택한 조회조건에 대한 목록을 조회합니다.
|
| 3 | PG승인정보 수신 | Api-common 서버를 호출해 PG사의 승인 정보를 수신합니다. |
| 4 | PG승인대사목록 수신 | PG사 api를 통해 PG사 승인 정보를 가져와 저장합니다.
|
| 5 | PG승인대사 | EC 결제 건과 PG사 승인 건의 금액이 일치하지 않을 시 (누락 포함) 불일치 사유를 등록합니다. |
| 6 | PG정산대사 요약 조회 | 선택한 조회조건에 대한 요약 정보를 조회합니다.
|
| 7 | PG정산대사 목록 조회 | 선택한 조회조건에 대한 목록을 조회합니다.
|
| 8 | PG정산정보 수신 | Api-common 서버를 호출해 PG사의 정산 정보를 수신합니다. |
| 9 | PG정산대사목록 수신 | PG사 api를 통해 PG사 정산 정보를 가져와 저장합니다.
|
| 10 | PG정산대사 조정사유 저장 | EC 입금예정액과 PG 입금금액 차이가 존재할 시 조정사유 및 조정금액을 저장합니다.
|
| 11 | PG정산대사 입금확정/입금확정취소 처리 | 입금금액차이가 0 인 건에 한해 입금확정 처리를 할 수 있습니다. |
API 기능 목록_PG승인대사
API | 설명 | Server | 메소드 | 비고 |
|---|---|---|---|---|
PG승인대사 요약조회 | PG승인대사 목록에 대한 요약 건수 및 합계를 조회합니다. | BO | POST | |
PG승인대사 목록조회 | PG승인대사 목록을 조회합니다. | BO | POST | |
PG승인정보 수신 | 특정 날짜, PG사에 대한 PG 승인 목록을 수신합니다.
| BO | POST |
|
PG승인대사 불일치사유 저장 | PG 승인 건과 EC 결제 건의 대사 불일치 사유를 저장합니다. | BO | POST | |
PG승인대사목록 수신 | 특정 날짜, PG사에 대한 PG 승인 목록을 PG사 인터페이스를 통해 수신합니다.
| Common | POST |
API 기능 목록_PG정산대사
API | 설명 | Server | 메소드 | 비고 |
|---|---|---|---|---|
PG정산대사 요약 조회 | PG정산대사 목록에 대한 요약정보를 조회합니다. | BO | POST | |
PG정산대사 목록 조회 | PG정산대사 목록을 조회합니다. | BO | POST | |
PG정산대사 조정사유 저장 | 입금금액이 불일치하는 건에 대해 금액을 조정하고 사유를 저장합니다. | BO | POST | |
PG정산정보 수신 | 특정 날짜, PG사에 대한 PG 정산 목록을 수신합니다. *PG정산대사목록 수신 - /api/common/v1/adjust/pgCompare/receivePgAdjustList | BO | POST | |
PG정산대사 입금확정/입금확정 취소 처리 | 입금금액이 일치하는 건에 대해 입금을 확정 처리하거나 입금확정에 대한 취소처리를 합니다. | BO | POST | |
PG 정산대사목록 수신 | 특정 날짜, PG사에 대한 PG 정산 목록을 PG사 인터페이스를 통해 수신합니다. *PG정산대사목록 수신 - /api/common/v1/adjust/pgCompare/receivePgAdjustList | Common | POST |
용어 정의
명칭 | 설명 | 비고 |
|---|---|---|
PG사 | 카드결제, 간편결제, 계좌이체, 가상계좌(무통장입금), 상품권결제, 휴대폰결제 등 다양한 결제 방식을 사용할 수 있게 연결해주는 역할을 합니다. |
|
기타 참고사항
현재 이니시스 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 한다.