계정·물류센터 등록

풀필먼트 계정 연동 흐름

토스쇼핑 셀러와 풀필먼트 계정 간 연결 관리를 위한 API에요. 절차는 다음과 같으니 참고해 주세요

풀필먼트 고객사 등록(연결) 요청

post

풀필먼트 계정(고객사)을 토스쇼핑 셀러와 연결합니다.

• 셀러가 토스쇼핑 파트너스에서 발급한 인증 정보로 호출합니다

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

X-Toss-Shopping-Connect-Api-KeystringRequired

토스쇼핑에서 발급한 연동 API Key

X-Toss-Shopping-Connect-Tx-IdstringRequired

요청별 고유 거래 식별값 (ASCII, 최대 64 byte)

Body

fulfillmentAccountKeystring · max: 64Required

풀필먼트 계정(고객사) 식별값

fulfillmentAccountNamestring · max: 128Required

풀필먼트 계정(고객사) 이름

createdAtstringRequired

풀필먼트 계정(고객사) 등록일시

Example: 2026-04-01T10:00:00

updatedAtstringRequired

풀필먼트 계정(고객사) 변경일시

Example: 2026-04-02T15:30:00

Responses

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

post/api/v3/shopping-fep/fulfillment/fulfillment-accounts

POST /api/v3/shopping-fep/fulfillment/fulfillment-accounts HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
X-Toss-Shopping-Connect-Api-Key: text
X-Toss-Shopping-Connect-Tx-Id: text
Content-Type: application/json
Accept: */*
Content-Length: 132

{
  "fulfillmentAccountKey": "text",
  "fulfillmentAccountName": "text",
  "createdAt": "2026-04-01T10:00:00",
  "updatedAt": "2026-04-02T15:30:00"
}

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_REQUEST",
    "reason": "text"
  },
  "success": {
    "success": true
  }
}

요청 예시

계정 등록 API는 OAuth2 Bearer Token과 API Key를 모두 헤더에 담아야 해요.

풀필먼트 고객사 등록(연결) 해제

post

풀필먼트 계정(고객사)과 토스쇼핑 셀러 간의 연결을 해제합니다.

• 해제 사유(reason)는 필수입니다

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

X-Toss-Shopping-Connect-Api-KeystringRequired

토스쇼핑에서 발급한 연동 API Key

X-Toss-Shopping-Connect-Tx-IdstringRequired

요청별 고유 거래 식별값 (ASCII, 최대 64 byte)

Body

fulfillmentAccountKeystring · max: 64Required

풀필먼트 계정(고객사) 식별값

reasonstring · max: 255Required

풀필먼트 계정(고객사) 해제 사유

Responses

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

post/api/v3/shopping-fep/fulfillment/fulfillment-accounts/delete

POST /api/v3/shopping-fep/fulfillment/fulfillment-accounts/delete HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
X-Toss-Shopping-Connect-Api-Key: text
X-Toss-Shopping-Connect-Tx-Id: text
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "fulfillmentAccountKey": "text",
  "reason": "text"
}

200

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_REQUEST",
    "reason": "text"
  },
  "success": {
    "success": true
  }
}