PortOne MCP Server

--- title: 스마트 라우팅 description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다. targetVersions: - v1 - v2 --- ## 스마트 라우팅이란? (관련 이미지 첨부) 스마트 라우팅은 원클릭 결제 트래픽 자동 분산 서비스로 최초 연동 이후 포트원 관리자콘솔 내에서 결제대행사 추가/삭제 및 결제대행사 별 결제 요청 비율을 설정할 수 있습니다. 노코드 방식으로 고객사에서 멀티 PG 인프라를 구성하는데 필요한 개발 리소스를 확 줄였습니다. SDK 일반결제 및 API 키인(수기) 결제 요청 시 스마트 라우팅 그룹 아이디를 지정하여 호출하는 경우 설정하신 그룹 내 결제대행사 비율에 따라 확률에 기반하여 결제를 요청합니다. API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정하여 호출하는 경우 설정하신 그룹 내 모든 결제대행사로 빌링키를 발급 요청합니다. 하나의 포트원 빌링키에 발급된 모든 결제대행사의 빌링키가 맵핑되며 이를 **슈퍼 빌링키**라고 부릅니다. 슈퍼 빌링키를 이용하여 빌링키 결제 또는 예약 결제 시 그룹 내 결제대행사 비율에 따라 확률에 기반하여 그 중 하나의 결제대행사 빌링키로 결제를 요청합니다. ## 사용 가능한 PG사 및 결제수단 <span id="available-pg" /> 스마트 라우팅 기능은 아래 PG사에 한하여 제공하고 있습니다. (추후 지원 PG사 확대 예정) <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START --> ### 결제창(SDK) 인증결제 - **나이스정보통신(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **(구) 나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **KG 이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **토스페이먼츠(신모듈)** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제 - **토스페이먼츠(구모듈)** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제 - **스마트로(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **스마트로(구모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 - **다날** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **키움페이** : 카드 / 실시간 계좌이체 / 가상계좌 - **헥토파이낸셜** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **KG모빌리언스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **KSNET** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **이지페이(KICC)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **웰컴페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **엑심베이** : 카드 ### API 수기(키인)결제 - **나이스정보통신(신모듈)** : 카드 - **NHN KCP** : 카드 - **KG 이니시스** : 카드 - **토스페이먼츠(신모듈)** : 카드 - **키움페이** : 카드 - **KSNET** : 카드 ### API 빌링키 발급 및 정기결제 - **나이스정보통신 (신모듈)** : 카드 - **(구) 나이스정보통신** : 카드 - **NHN KCP** : 카드 - **KG이니시스** : 카드 - **토스페이먼츠(신모듈)** : 카드 - **키움페이** : 카드 - **헥토파이낸셜** : 카드 - **KSNET** : 카드 - **웰컴페이먼츠** : 카드 <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END --> <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START --> ### 결제창(SDK) 인증결제 - **나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **KG이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **토스페이먼츠** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제 - **한국결제네트웍스(KPN)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **KSNET** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **스마트로** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 - **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제 ### API 수기(키인)결제 - **나이스정보통신** : 카드 / 가상계좌 - **KG이니시스** : 카드 / 가상계좌 - **토스페이먼츠** : 카드 / 가상계좌 - **한국결제네트웍스(KPN)** : 카드 / 가상계좌 - **KSNET** : 카드 / 가상계좌 - **스마트로** : 가상계좌 - **NHN KCP** : 카드 / 가상계좌 ### API 빌링키 발급 및 정기결제 - **나이스정보통신** : 카드 - **KG이니시스** : 카드 - **토스페이먼츠** : 카드 - **한국결제네트웍스(KPN)** : 카드 - **KSNET** : 카드 - **스마트로** : 카드 - **NHN KCP** : 카드 <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END --> ## 스마트 라우팅 연동 안내 (관련 이미지 첨부) 스마트 라우팅을 사용하기 위해서는 포트원 관리자콘솔 내 \[연동 관리] - \[스마트 라우팅]에서 그룹 설정이 필요합니다. 자세한 내용은 [스마트 라우팅 그룹 설정 가이드](https://developers.portone.io/opi/ko/extra/smart-routing/console-guide)에서 확인할 수 있습니다. 그룹 설정 후 결제 요청 시 `channelGroupId` 파라미터를 지정하여 호출해야 합니다. 자세한 내용은 [스마트 라우팅 연동하기](https://developers.portone.io/opi/ko/extra/smart-routing/integration)에서 확인할 수 있습니다. ## 스마트 라우팅 FAQ <details> <summary> 스마트 라우팅 그룹 이용 시 지원되는 모든 결제수단을 사용할 수 있는건가요? </summary> 스마트 라우팅 그룹을 지정하여 결제 호출 시 결제 수단에 대한 제약은 없습니다. 다만, 스마트 라우팅 이용 시 동일한 그룹 내에 설정된 채널은 가급적 동일한 결제수단으로 계약이 완료되어 있어야 합니다. ex) 카드 및 가상계좌 이용을 원하시는 경우 스마트 라우팅 그룹에서 사용할 모든 PG사와 카드 및 가상계좌 사용 계약이 필요합니다. 그렇지 않는 경우 결제 호출 시 결제 수단에 따라 에러가 리턴될 수 있으며, 결제창 호출이 불가능할 수 있습니다. </details> <details> <summary> 간편결제도 스마트 라우팅 기능을 사용할 수 있나요? </summary> **간편결제 허브형을 사용하시는 경우**, 결제대행사 별 계약에 따라 결제창에 표시되는 간편결제가 상이할 수 있습니다. **간편결제 다이렉트 호출을 사용하시는 경우**, 결제대행사 별 계약에 따라 결제 호출 시 에러가 리턴되며 결제창이 호출되지 않을 수 있습니다. 가급적 결제대행사 별 동일한 간편결제 수단을 모두 계약하신 후 사용하시길 권장드립니다. 단, **간편결제 직연동**의 경우 스마트 라우팅 기능을 제공하지 않습니다. </details> <details> <summary> SDK(결제창) 빌링키 발급할 때도 사용하고 싶어요!</summary> SDK(결제창) 빌링키 발급의 경우 해당 기능을 지원하지 않습니다. 빌링키 발급 시 스마트 라우팅 기능을 사용하고 싶으신 경우 API 방식으로 빌링키를 발급하여 사용하시길 권장드립니다. </details>