결제에 필요한 결제수단은 크게 주결제수단과 부결제수단으로 나뉘어집니다. 결제 요청한 결제수단 중 주결제수단이 존재하면 결제수단 연결여부 API 를 호출하여 사용여부를 검증합니다. 검증이 끝나면 가맹점 정보 조회 API 를 호출하여 가맹점 정보를 조회합니다. PG 인증 창을 호출하기 위해 추가적인 정보가 필요한 결제라면 추가정보 조회 API 를 호출합니다. 준비된 결제정보를 이용하여 PG 인증 창을 호출합니다.
주요 기능
결제수단 연결여부는 BO의 주문/결제 > 결제수단 관리 > 결제수단 관리에서 관리합니다.
가맹점 정보는 BO의 주문/결제 > 결제수단 관리 > 가맹점 관리에서 관리합니다.
무이자할부 안내 정보는 BO의 주문/결제 > 결제수단 관리 > 무이자할부 안내 관리에서 관리합니다.
계좌인증용 MID 는 app 의 properties 파일에서 관리합니다.
프로세스 정의
번호 | 업무 | 설명 |
|---|---|---|
1 | 결제 수단 연결여부 조회 | PG 사에 등록된 결제수단의 연결여부를 조회합니다. 해당 데이터는 BO의 주문/결제 > 결제수단 관리 > 결제수단 관리에서 관리합니다. |
2 | 가맹점 정보 조회 | PG 결제를 위해 가맹점 정보를 조회합니다. 해당 데이터는 BO의 주문/결제 > 결제수단 관리 > 가맹점 관리에서 관리합니다. |
3 | 이니시스 PG 파라미터 생성 | 이니시스 PC 결제요청 시 인증창 호출에 필요한 파라미터를 생성합니다. |
4 | 무이자 할부 안내 목록조회 | 신용카드의 무이자 할부 안내 목록을 조회합니다. 조회한 데이터는 결제수단 무이자 할부 안내 팝업 노출에 사용됩니다. 해당 데이터는 BO의 주문/결제 > 결제수단 관리 > 무이자할부 안내 관리에서 관리합니다. |
5 | MID 조회 | 계좌인증 전용 MID 를 조회합니다. 조회한 데이터는 환불계좌등록에 사용됩니다. 해당 데이터는 app의 properties 파일에서 관리합니다. |
6 | PG 정보 조회 | 결제수단 코드를 이용하여 PG 정보를 조회합니다. 결제수단 코드에 맞는 현재 결제수단 연결여부와 사용여부가 Y인 PG 정보를 조회합니다. 주문서 조회, 클레임 추가 금액 결제 시 서비스 호출되어 사용됩니다. |
API 기능 목록
API | 설명 | Server | 매소드 | 비고 |
|---|---|---|---|---|
결제수단 연결여부 조회 | PG 사에 등록된 결제수단의 연결여부를 조회합니다. | Order | POST | |
가맹점 정보 조회 | PG 결제를 위해 가맹점 정보를 조회합니다. 조회 내역이 없을 경우 PG 결제가 불가능합니다. | Order | POST | |
이니시스 PC 결제요청 파라미터 생성 | 이니시스 PC 결제요청 시 인증 창 호출에 필요한 파라미터를 생성합니다. | Order | POST | |
무이자할부 안내 목록 조회 | 신용카드의 무이자할부 안내 목록을 조회합니다. 조회한 데이터는 주문서의 결제수단 무이자 할부 안내 팝업 노출에 사용됩니다. | Order | GET | |
계좌인증용 MID 조회 | 계좌인증 전용 MID 를 조회합니다. 조회한 데이터는 환불계좌등록에 사용됩니다. | Order | GET | |
PG 정보 조회 | 결제수단 코드를 이용하여 PG 정보를 조회합니다. 결제수단 코드에 맞는 현재 결제수단 연결여부와 사용여부가 Y인 PG 정보를 조회합니다. 주문서 조회, 클레임 추가 금액 결제 시 서비스 호출되어 사용됩니다. | Order | POST |
용어 정의
명칭 | 설명 | 비고 |
|---|---|---|
PG(Payment Gateway) | 결제대행사를 뜻하는 용어로 카드사 혹은 은행사와 이커머스 사 간 결제 업무를 대신 진행한다. | |
MID | 이커머스 사와 PG사 사이에서 발급되어 관리되는 가맹점 번호를 지칭합니다. |