설명서저장 및 구매 경험

미국 우편 서비스(USPS)

마지막 업데이트: 2026년 5월 14일

작성 대상:

  • Beginner
  • Intermediate
  • Admin
  • User

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

1단계: USPS 배송 계정 열기

USPS 개발자 포털 계정을 엽니다. 등록 프로세스를 완료하면 사용자 ID와 USPS 테스트 서버에 대한 URL을 받게 됩니다. USPS API에 대한 자세한 내용은 기술 설명서를 참조하세요.

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

NOTE
이러한 지침에는 통합을 위해 USPS API 유형을 선택하는 단계(Web Tools API 또는 REST API)가 포함됩니다. USPS는 더 이상 Web Tools API를 지원하지 않으므로 해당 REST API를 구성해야 합니다. REST API 옵션이 표시되지 않으면 Commerce 애플리케이션에 USPS REST API 마이그레이션 품질 패치​(AC-1520)를 적용해야 합니다.

  1. 관리자 사이드바에서 Stores > Settings>Configuration(으)로 이동합니다.

  2. 왼쪽 패널에서 Sales​을(를) 확장하고 Delivery Methods​을(를) 선택합니다.

  3. USPS 섹션에서 확장 선택기 를 확장합니다.

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

  4. Enabled for Checkout​을(를) Yes(으)로 설정합니다.

  5. USPS Type​을(를) USPS REST API(으)로 설정합니다.

    note
    NOTE
    USPS는 더 이상 USPS Web Tools API를 지원하지 않습니다.

  6. 필요한 경우 Gateway URL​을(를) 입력하여 USPS 배송 속도에 액세스하십시오.

    필드는 기본적으로 미리 설정되어 있으며 일반적으로 변경할 필요가 없습니다.

  7. 체크아웃 중에 표시되는 이 배송 방법에 대한 Title​을(를) 입력하십시오.

  8. USPS에서 제공한 자격 증명을 사용하여 다음 필드를 완료합니다.

    USPS Rest API를 사용하는 경우 다음 자격 증명을 제공합니다.

    • Consumer Key
    • Consumer Secret
    • Pricing Options

    USPS Web Tools API를 사용하는 경우 다음 자격 증명을 제공합니다.

    • User ID
    • Password

  9. Mode​을(를) 다음 중 하나로 설정합니다.

    • Development - 테스트 환경에서 USPS를 실행합니다. 개발 환경에서 USPS를 실행한 후 나중에 다시 돌아와 모드를 Live(으)로 설정하십시오.
    • Live - 라이브 프로덕션 환경에서 USPS를 실행합니다.

3단계: 패키징 설명 완료

  1. 여러 패키지로 보낼 경우 순서를 관리하는 방법을 결정하려면 Packages Request Type​을(를) 다음 중 하나로 설정합니다.

    • Divide to Equal Weight - (1개의 요청) 패키지가 동일한 가중치로 나누어진 경우 여러 패키지의 배송을 하나의 요청으로 제출할 수 있습니다.
    • Use Origin Weight - (복수 요청) 배송비 계산 기준으로 원본 가중치를 사용하는 경우 복수 패키지를 별도의 요청으로 제출해야 합니다.

  2. 상점에 주문한 제품을 배송하는 데 일반적으로 사용되는 포장 형식으로 Container​을(를) 설정합니다.

  3. 스토어에서 제공되는 일반 패키지의 Size​을(를) 설정합니다.

  4. Machinable​을(를) 다음 중 하나로 설정합니다.

    • Yes - 컴퓨터에서 일반 패키지를 처리할 수 있는 경우.
    • No - 일반 패키지를 수동으로 처리해야 하는 경우.

  5. 통신사 요구 사항에 따라 Maximum Package Weight​을(를) 입력하십시오.

    USPS 패키징 설정 {width="600" modal="regular"}

4단계: 취급 수수료 설정

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

  1. Calculate Handling Fee​을(를) 다음 메서드 중 하나로 설정합니다.

    • Fixed
    • Percent

  2. 처리 요금이 적용되는 방법을 확인하려면 Handling Applied​을(를) 다음 중 하나로 설정하십시오.

    • Per Order
    • Per Package

  3. Handling Fee​의 청구 금액을 입력하십시오.

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

    USPS 취급 수수료 {width="600" modal="regular"}

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

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

    이 메서드는 체크아웃 중에 USPS에 표시됩니다. 여러 메서드를 선택하려면 Ctrl 키(PC) 또는 Command 키(Mac)를 누른 채 각 옵션을 클릭합니다.

  2. USPS를 통해 무료 배송 옵션을 제공하려면 무료 배송 옵션을 설정하십시오.

    • 무료 배송에 사용할 메서드로 Free Method​을(를) 설정하십시오. USPS를 통한 무료 배송을 제공하지 않으려면 None을(를) 선택하세요.

    • USPS와 함께 무료 배송에 대한 주문을 허용하는 최소 주문 금액이 필요하려면 Enable Free Shipping Threshold​을(를) Enable(으)로 설정하십시오. Free Shipping Amount Threshold​에 최소값을 입력하십시오.

  3. 필요한 경우 Displayed Error Message​을(를) 변경합니다.

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

    USPS 허용 메서드 {width="600" modal="regular"}

  4. Ship to Applicable Countries​을(를) 다음 중 하나로 설정합니다.

    • All Allowed Countries - 스토어 구성에 지정된 모든 국가의 고객이 이 게재 방법을 사용할 수 있습니다.
    • Specific Countries - 이 옵션을 선택하면 특정 국가로 배송 목록이 나타납니다. 목록에서 이 게재 방법을 사용할 수 있는 각 국가를 선택합니다.

    USPS 적용 국가 {width="600" modal="regular"}

  5. Show Method if Not Applicable​을(를) 다음 중 하나로 설정합니다.

    • Yes - 체크아웃 중에 사용 가능한 모든 USPS 배송 방법을 나열하며, 배송에 적용되지 않는 방법도 포함합니다.
    • No - 배송에 적용할 수 있는 USPS 배송 방법만 나열합니다.

  6. 스토어에서 만든 USPS 배송의 세부 정보를 사용하여 로그 파일을 만들려면 Debug​을(를) Yes(으)로 설정합니다.

  7. Sort Order​의 경우 체크아웃 중에 다른 게재 방법과 함께 나열할 때 USPS가 표시되는 순서를 결정하려면 숫자를 입력하십시오.

    0 = 첫 번째, 1 = 두 번째, 2 = 세 번째 등입니다.

  8. Save Config​을(를) 클릭합니다.

recommendation-more-help
commerce-admin-help-stores-purchase