상품 결제 전환 사양

목적

상품 결제처럼 사용자의 구매 의도가 뚜렷한 상황에서 ChatGPT가 파트너 플러그인을 직접 호출할 수 있도록 하는 것이 목표입니다.

파트너가 검색용 상품 피드를 제공하면 해당 파트너의 MCP 서버를 연결해 구매로 이어지는 최종 단계의 작업을 처리할 수 있습니다. 이를 위해 파트너 플러그인은 위젯 이름, 도구 이름, 도구 입력에 관한 표준 규약을 따라야 합니다.

이 사양에 맞는 플러그인을 개발하려면 ChatGPT 판매자 신청 양식을 작성해 이용을 신청하세요.

사용자 경험

사용자가 상품을 검색하면 상품 정보 사이드바에 판매자별 열기 버튼이 표시될 수 있습니다. 판매자가 플러그인을 제공하면 ChatGPT는 대화 안에서 해당 플러그인을 열어 사용자가 외부 웹사이트로 이동하지 않고 결제할 수 있도록 합니다.

현재 필수 규약

• 위젯 이름: ui://widget/checkout-session.html
• 도구 이름: checkout_session

checkout_session에서는 다음과 같이 설정해야 합니다.

_meta.ui.resourceUri = "ui://widget/checkout-session.html";

위젯에서 직접 호출하는 모든 도구에는 다음 설정이 필요합니다.

_meta["openai/widgetAccessible"] = true;

checkout_session 입력

각 결제 항목에서 필수 필드는 id와 quantity뿐입니다. offerId와 선택한 판매 제안의 메타데이터는 선택 사항입니다.

{
  "checkout_session": {
    "items": [
      {
        "id": "string",
        "quantity": 1,
        "offerId": "string",
        "name": "Wireless headphones",
        "description": "Wireless headphones with noise cancellation.",
        "images": [
          "https://merchant.example.com/images/headphones.jpg",
          "https://merchant.example.com/images/headphones-side.jpg"
        ],
        "url": "https://merchant.example.com/products/headphones",
        "merchant_name": "Example Merchant",
        "price": "$24.99"
      }
    ]
  }
}

다음은 결제 항목에 포함할 수 있는 선택 필드입니다.

images에는 선택한 판매자의 피드에서 가져온 URL이 0개 이상 포함됩니다. URL이 있으면 첫 번째 URL의 이미지를 대표 이미지로 표시합니다. ChatGPT는 값이 없는 선택 필드를 생략합니다. 상품 설명을 생성하거나 다른 판매자의 설명이나 이미지를 사용하지 않습니다. 도구의 입력 스키마에서 이 필드들을 선택 사항으로 선언하세요. 결제 항목 ID와 판매 제안 ID를 사용해 자체 카탈로그에서 정확한 상품, 재고 및 가격 데이터를 조회하세요.

중첩된 결제 세션의 구조는 Commerce 사양에 정의된 결제 세션 구조와 일치합니다.