미국 우편 서비스(USPS)

Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

초급
중간
관리자
사용자

미국 우편 서비스는 미국 정부의 독립 우편 서비스로, 육로와 항공에 의해 국내 및 국제 배송 서비스를 제공합니다.

1단계: USPS 배송 계정 열기

USPS 웹 도구 계정을 엽니다. 등록 프로세스를 완료하면 사용자 ID와 USPS 테스트 서버에 대한 URL을 받게 됩니다.

USPS 웹 도구 계정을 열 수도 있습니다. 등록 프로세스를 완료하면 사용자 ID와 USPS 테스트 서버에 대한 URL을 받게 됩니다. USPS 웹 도구에 대한 자세한 내용은 기술 설명서를 참조하세요.

2단계: 스토어에 대해 USPS 활성화

NOTE

이러한 지침에는 통합을 위해 USPS API 유형을 선택하는 단계(Web Tools API 또는 REST API)가 포함됩니다. API 유형 구성 옵션은 Commerce 애플리케이션에 USPS REST API 마이그레이션 품질 패치(AC-1520)를 적용한 경우에만 사용할 수 있습니다. 패치를 적용하지 않은 경우 API 유형 선택기를 사용할 수 없으며 USPS Web Tools API가 기본적으로 사용됩니다.
USPS API는 USPS와 통합하기 위한 기본 방법입니다. USPS 웹 도구 API는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 수 있습니다.

관리자 사이드바에서 Stores > Settings>Configuration(으)로 이동합니다.
왼쪽 패널에서 Sales을(를) 확장하고 Delivery Methods을(를) 선택합니다.

확장 선택기 USPS 를 확장합니다.

note note
NOTE
필요한 경우 먼저 Use system value 확인란의 선택을 해제하여 설명된 대로 다음 설정을 변경합니다.

Enabled for Checkout을(를) Yes(으)로 설정합니다.
USPS REST API를 사용하는 경우 USPS Type을(를) USPS Rest APIs(으)로 설정하십시오.

USPS Web Tools API를 사용하는 경우 USPS Type을(를) USPS Web Tools API(으)로 설정하십시오.
필요한 경우 Gateway URL을(를) 입력하여 USPS 배송 속도에 액세스하십시오.

필드는 기본적으로 미리 설정되어 있으며 일반적으로 변경할 필요가 없습니다.
체크아웃 중에 표시되는 이 배송 방법에 대한 Title을(를) 입력하십시오.
USPS에서 제공한 자격 증명을 사용하여 다음 필드를 완료합니다.

USPS Rest API를 사용하는 경우 다음 자격 증명을 제공해야 합니다.
- Consumer Key
- Consumer Secret
- Pricing Options
USPS Web Tools API를 사용하는 경우 다음 자격 증명을 제공해야 합니다.
- User ID
- Password
Mode을(를) 다음 중 하나로 설정합니다.
- Development - 테스트 환경에서 USPS를 실행합니다. 개발 환경에서 USPS를 실행한 후 나중에 다시 돌아와 모드를 Live(으)로 설정하십시오.
- Live - 라이브 프로덕션 환경에서 USPS를 실행합니다.

3단계: 패키징 설명 완료

여러 패키지로 보낼 경우 순서를 관리하는 방법을 결정하려면 Packages Request Type을(를) 다음 중 하나로 설정합니다.
- Divide to Equal Weight - (1개의 요청) 패키지가 동일한 가중치로 나누어진 경우 여러 패키지의 배송을 하나의 요청으로 제출할 수 있습니다.
- Use Origin Weight - (복수 요청) 배송비 계산 기준으로 원본 가중치를 사용하는 경우 복수 패키지를 별도의 요청으로 제출해야 합니다.
상점에 주문한 제품을 배송하는 데 일반적으로 사용되는 포장 형식으로 Container을(를) 설정합니다.
스토어에서 제공되는 일반 패키지의 Size을(를) 설정합니다.
Machinable을(를) 다음 중 하나로 설정합니다.
- Yes - 컴퓨터에서 일반 패키지를 처리할 수 있는 경우.
- No - 일반 패키지를 수동으로 처리해야 하는 경우.
통신사 요구 사항에 따라 Maximum Package Weight을(를) 입력하십시오.

{width="600" modal="regular"}

4단계: 취급 수수료 설정

처리 요금은 선택 사항이며 DHL 배송 비용에 추가되는 추가 비용으로 표시됩니다. 처리 수수료를 포함하려면 다음을 수행하십시오.

Calculate Handling Fee을(를) 다음 메서드 중 하나로 설정합니다.
- Fixed
- Percent
처리 요금이 적용되는 방법을 확인하려면 Handling Applied을(를) 다음 중 하나로 설정하십시오.
- Per Order
- Per Package
Handling Fee의 청구 금액을 입력하십시오.

백분율을 입력하려면 십진수 형식을 사용합니다. 예를 들어 25%에 대해 0.25을(를) 입력합니다.

{width="600" modal="regular"}

5단계: 허용된 방법 및 적용 가능한 국가 지정

Allowed Methods의 경우 고객이 사용할 수 있는 각 USPS 배송 방법을 선택하십시오.

이 메서드는 체크아웃 중에 USPS에 표시됩니다. 여러 메서드를 선택하려면 Ctrl 키(PC) 또는 Command 키(Mac)를 누른 채 각 옵션을 클릭합니다.
USPS를 통해 무료 배송 옵션을 제공하려면 무료 배송 옵션을 설정하십시오.
- 무료 배송에 사용할 메서드로 Free Method을(를) 설정하십시오. USPS를 통한 무료 배송을 제공하지 않으려면 None을(를) 선택하세요.
- USPS와 함께 무료 배송에 대한 주문을 허용하는 최소 주문 금액이 필요하려면 Enable Free Shipping Threshold을(를) Enable(으)로 설정하십시오. Free Shipping Amount Threshold에 최소값을 입력하십시오.
필요한 경우 Displayed Error Message을(를) 변경합니다.

이 텍스트 상자는 기본 메시지가 사전 설정되어 있지만 USPS를 사용할 수 없는 경우 표시할 다른 메시지를 입력할 수 있습니다.

{width="600" modal="regular"}
Ship to Applicable Countries을(를) 다음 중 하나로 설정합니다.
- All Allowed Countries - 스토어 구성에 지정된 모든 국가의 고객이 이 게재 방법을 사용할 수 있습니다.
- Specific Countries - 이 옵션을 선택하면 특정 국가로 배송 목록이 나타납니다. 목록에서 이 게재 방법을 사용할 수 있는 각 국가를 선택합니다.
{width="600" modal="regular"}
Show Method if Not Applicable을(를) 다음 중 하나로 설정합니다.
- Yes - 체크아웃 중에 사용 가능한 모든 USPS 배송 방법을 나열하며, 배송에 적용되지 않는 방법도 포함합니다.
- No - 배송에 적용할 수 있는 USPS 배송 방법만 나열합니다.
스토어에서 만든 USPS 배송의 세부 정보를 사용하여 로그 파일을 만들려면 Debug을(를) Yes(으)로 설정합니다.
Sort Order의 경우 체크아웃 중에 다른 게재 방법과 함께 나열할 때 USPS가 표시되는 순서를 결정하려면 숫자를 입력하십시오.

0 = 첫 번째, 1 = 두 번째, 2 = 세 번째 등입니다.
Save Config을(를) 클릭합니다.

recommendation-more-help

dacea746-44a9-4368-b3fb-3bcff64c6be1