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

스마트 라우팅

스마트 라우팅 기능을 소개합니다.

스마트 라우팅이란?

스마트 라우팅은 원클릭 결제 트래픽 자동 분산 서비스로 최초 연동 이후 포트원 관리자콘솔 내에서 결제대행사 추가/삭제 및 결제대행사 별 결제 요청 비율을 설정할 수 있습니다. 노코드 방식으로 고객사에서 멀티 PG 인프라를 구성하는데 필요한 개발 리소스를 확 줄였습니다.

SDK 일반결제 및 API 키인(수기) 결제 요청 시 스마트 라우팅 그룹 아이디를 지정하여 호출하는 경우 설정하신 그룹 내 결제대행사 비율에 따라 확률에 기반하여 결제를 요청합니다.

API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정하여 호출하는 경우 설정하신 그룹 내 모든 결제대행사로 빌링키를 발급 요청합니다. 하나의 포트원 빌링키에 발급된 모든 결제대행사의 빌링키가 맵핑되며 이를 슈퍼 빌링키라고 부릅니다. 슈퍼 빌링키를 이용하여 빌링키 결제 또는 예약 결제 시 그룹 내 결제대행사 비율에 따라 확률에 기반하여 그 중 하나의 결제대행사 빌링키로 결제를 요청합니다.

사용 가능한 PG사 및 결제수단

스마트 라우팅 기능은 V2 결제 서비스 이용 시 사용이 가능하며, 아래 PG사에 한하여 제공하고 있습니다. (추후 지원 PG사 확대 예정)

결제창(SDK) 인증결제

  • 나이스페이먼츠 : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
  • KG이니시스 : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
  • 토스페이먼츠 : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
  • 한국결제네트웍스(KPN) : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
  • KSNET : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
  • 스마트로 : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
  • NHN KCP (6월 중 제공예정)

API 수기(키인)결제

  • 나이스페이먼츠 : 카드 / 가상계좌
  • KG이니시스 : 카드 / 가상계좌
  • 토스페이먼츠 : 카드 / 가상계좌
  • 한국결제네트웍스(KPN) : 카드 / 가상계좌
  • KSNET : 카드 / 가상계좌
  • 스마트로 : 가상계좌
  • NHN KCP (6월 중 제공예정)

API 빌링키 발급 및 정기결제

  • 나이스페이먼츠 : 카드
  • KG이니시스 : 카드
  • 토스페이먼츠 : 카드
  • 한국결제네트웍스(KPN) : 카드
  • KSNET : 카드
  • 스마트로 : 카드
  • NHN KCP (6월 중 제공예정)

스마트 라우팅 연동 안내

스마트 라우팅을 사용하기 위해서는 포트원 관리자콘솔 내 [연동 관리] - [스마트 라우팅]에서 그룹 설정이 필요합니다. 자세한 내용은 스마트 라우팅 그룹 설정 가이드에서 확인할 수 있습니다.

그룹 설정 후 결제 요청 시 channelGroupId 파라미터를 지정하여 호출해야 합니다. 자세한 내용은 스마트 라우팅 연동하기에서 확인할 수 있습니다.

스마트 라우팅 FAQ

스마트 라우팅 그룹 이용 시 지원되는 모든 결제수단을 사용할 수 있는건가요?

스마트 라우팅 그룹을 지정하여 결제 호출 시 결제 수단에 대한 제약은 없습니다. 다만, 스마트 라우팅 이용 시 동일한 그룹 내에 설정된 채널은 가급적 동일한 결제수단으로 계약이 완료되어 있어야 합니다.

ex) 카드 및 가상계좌 이용을 원하시는 경우 스마트 라우팅 그룹에서 사용할 모든 PG사와 카드 및 가상계좌 사용 계약이 필요합니다.

그렇지 않는 경우 결제 호출 시 결제 수단에 따라 에러가 리턴될 수 있으며, 결제창 호출이 불가능할 수 있습니다.

간편결제도 스마트 라우팅 기능을 사용할 수 있나요?

간편결제 허브형을 사용하시는 경우, 결제대행사 별 계약에 따라 결제창에 표시되는 간편결제가 상이할 수 있습니다.

간편결제 다이렉트 호출을 사용하시는 경우, 결제대행사 별 계약에 따라 결제 호출 시 에러가 리턴되며 결제창이 호출되지 않을 수 있습니다. 가급적 결제대행사 별 동일한 간편결제 수단을 모두 계약하신 후 사용하시길 권장드립니다.

단, 간편결제 직연동의 경우 스마트 라우팅 기능을 제공하지 않습니다.

SDK(결제창) 빌링키 발급할 때도 사용하고 싶어요!

SDK(결제창) 빌링키 발급의 경우 해당 기능을 지원하지 않습니다. 빌링키 발급 시 스마트 라우팅 기능을 사용하고 싶으신 경우 API 방식으로 빌링키를 발급하여 사용하시길 권장드립니다.