개발자센터
V1
V2
릴리즈 노트 기술 블로그

복수 PG설정 및 사용하기

복수 PG를 사용하는 경우 설정방법을 확인할 수 있습니다.

이 문서는 포트원 관리자 콘솔에서 복수의 PG사를 설정하여 원하는 결제 수단으로 결제창을 호출하는 방법을 설명합니다.

PG 설정하기

추가 설정이 필요한 PG설정정보를 아래와 같이 설정해 주세요.

포트원 관리자 콘솔 > 결제 연동 > 테스트/실 연동 > 실 연동 또는 테스트 연동 선택 > PG사 / PG 모듈 선택 > [+추가] 클릭

특정 PG사의 결제창 열기

결제창을 호출하기 위한 JavaScript SDK IMP.request_pay를 호출할 때 param.pg 속성에 미리 등록한 PG사를 지정하여 해당 PG사의 결제창을 호출할 수 있습니다. pg 속성에는 다음과 같은 형태로 PG 값을 지정할 수 있습니다.

  • { PG사 코드값 }
  • { PG사 코드값 }.{ PG사 상점아이디 }

만약 포트원 관리자 콘솔 PG사 등록 현황이 아래와 같이 3개의 PG설정을 등록했다고 가정해 보면,

PG사상점아이디 (예시)용도
(신) 나이스페이먼츠MID-a인증 결제용
(신) 나이스페이먼츠MID-b비인증 결제용
카카오페이MID-c인증 결제용

위에서 등록한 PG 설정 중 { PG사 코드값 } 으로만 구분할 수 있는 PG사는 카카오페이입니다. 다음과 같이 pg 속성에 kakaopay를 지정하면 등록한 카카오페이 설정으로 결제창이 호출됩니다

IMP.request_pay({
  pg: "kakaopay", // 카카오페이 결제창 호출
  amount: 1000,
  name: "테스트 주문",
  buyer_name: "구매자",
  buyer_email: "buyer@iamport.kr",
});

위에서 등록한 PG 설정 중 (신) 나이스페이먼츠 (인증 결제용)(신) 나이스페이먼츠 (비인증 결제용) 의 경우 PG사 코드값이 동일하기 때문에 pg 속성을 코드값과 상점아이디를 조합한 값 { PG사 코드값 }.{ PG사 상점아이디 } 으로 설정해서 구분해야 합니다.

IMP.request_pay({
  pg: "nice_v2.MID-a", // (신) 나이스페이먼츠 인증 결제용 호출 (상점아이디 MID-a 적용)
  amount: 1000,
  name: "테스트 주문",
  buyer_name: "구매자",
  buyer_email: "buyer@iamport.kr",
});

pg 속성 매칭 우선순위

관리자 콘솔에서 PG 설정을 저장한 순서(오래된순)대로 pg 속성의 조건과 일치하는 설정을 찾습니다.