API 키

결제선생 파트너는 인증에 API key를 사용합니다. API 연동에 필요한 통신과 사업장을 인증하는 역할을 합니다.

API key 이해하기

결제선생 파트너 연동 시 각 파트너별로 고유한 API key를 발급받게 됩니다. API key는 사업장 정보를 인증함과 동시에 결제선생 API에서 유효한 파트너를 통해 호출되었다는 인증도 같이 진행됩니다. 따라서 발급받은 API key가 외부에 유출되지 않도록 유의하셔야 합니다.

API key 발급 받기

API key는 파트너가 임의로 사용할 수 없습니다. 운영환경과 개발환경에 따라 API key가 엄격하게 구분되어 있으며 각 API key의 발급 시점이 별도로 존재합니다. (개발환경 API KEY는 V1, V2는 혼용이 가능합니다)

Sandbox API key 발급받기

개발 환경 API key는 페이민트를 통해 파트너 계약을 맺음과 동시에 발급이 진행됩니다. 발급받은 개발 환경 API key는 개발 환경에서만 사용할 수 있습니다.

Live API Key 발급받기

운영 환경 API key는 개발환경에서 연동검수 완료 이후에 발급됩니다 발급받은 운영 환경 API key는 운영 환경에서만 사용할 수 있습니다.

API Key와 Merchant 구분

• Merchant 값은 하위사업장을 구분하는 값으로 일반적인 상점아이디(MID)와 유사합니다.

• 파트너에서 생성한 Merchant 는 결제선생에 전달되면 해당 사업장은 파트너의 하위사업장으로 등록됩니다.

버전별 API key 사용하기

API key는 결제선생 api가 제공하는 v1, v2 버전의 모든 API에서 제한없이 사용할 수 있습니다