Search

OAuth clientId & clientSecret 발급 및 유효성 검증

협력사 → 토스 전달 체크리스트

•
방화벽 오픈을 위한 개발/운영 협력사 IP 전달

OAuth clientId & clientSecret 발급

1.
판매자가 토스 셀러 어드민 홈페이지을 통해 OAuth 키 생성 버튼 클릭
2.
판매자가 merchantId, merchantUserLoginId, clientId , clientSecret를 협력사에 전달
a.
토스 쇼핑 셀러 어드민 홈페이지 주소: https://shopping-seller.toss.im
b.
판매자가 토스 셀러어드민 → 협력사로 전달해야 할 정보
필드명
설명
merchantId
상점 ID = 셀러 ID
merchantUserLoginId
판매자의 토스 셀러어드민 로그인 ID
clientId
oauth 클라이언트 ID = Access Key
clientSecret
oauth 클라이언트 Secret = Secret key
sequenceDiagram
	actor seller as 판매자
	participant toss-shopping-admin as 토스 쇼핑 셀러 어드민 홈페이지
	participant toss-auth as 토스 인증 서버
	participant contractor as 협력사
	participant toss-shopping-server as 토스 쇼핑 서버

	seller ->> toss-shopping-admin : oauth 키 발급 요청
	activate toss-shopping-admin
	toss-shopping-admin ->> toss-auth: oauth 키 발급 요청
	toss-auth -->> toss-shopping-admin : clientId, clientSecret, merchantId, merchantUserLoginId 전달
	toss-shopping-admin -->> seller : clientId, clientSecret, merchantId, merchantUserLoginId 전달
	deactivate toss-shopping-admin

	seller ->> contractor: 토스에서 발급받은 clientId, clientSecret, merchantId, merchantUserLoginId 전달	
	
	contractor ->> toss-shopping-server: clientId, clientSecret, merchantId, merchantUserLoginId 전달하여 유효성 판단 요청
	activate toss-shopping-server
	toss-shopping-server ->> contractor: clientId, clientSecret 유효성 판단 결과 전달
	deactivate toss-shopping-server
Mermaid
복사

clientId & clientSecret 유효성 판단 요청

URL

/api/v3/shopping-fep/{company_name}/merchants/oauth

Method

POST

Request

Search
Request body
필드명
필수여부
Type
설명
merchantId
Open
필수
Long
상점 ID
merchantUserLoginId
Open
필수
String
판매자의 토스 셀러어드민 로그인 ID
clientId
Open
필수
String
판매자가 토스 셀러어드민에서 발급받은 clientId
clientSecret
Open
필수
String
판매자가 토스 셀러어드민에서 발급받은 clientSecret

Response

Search
Response body
필드명
필수여부
Type
설명
resultType
Open
필수
Enum
응답 결과 유형
success
Open
필수
Object?
응답 데이터
error
Open
선택
Object?
에러
응답의 “resultType”: “SUCCESS”인 경우, 유효성 통과

응답 예시

{ "resultType": "FAIL", "error": { "errorType": 0, "errorCode": "4010", "reason": "허가되지 않은 요청입니다.", "data": {}, "title": null }, "success": null }
JavaScript
복사
Made with