카트, 태그 및 항목

OmniCart는 기본적으로 결제 요청에 여러 품목을 수락하도록 설계되었으므로 각 결제 요청에 단일 품목이 포함되어 있더라도 하나의 장바구니로 생각할 수 있습니다. 카트에 있는 품목은 태그로 표시할 수 있습니다.

카트에 있는 항목

오른쪽 코드는 장바구니 시작 요청에 필요한 필수 속성만 포함된 간단한 요청의 예입니다.

각 카트에는 회원님 측에서 생성한 고유한 cartId 주소가 있어야 합니다. currency 속성은 필수이며 전체 카트에 적용됩니다.

여기서 pegasus 객체는 필수 amount 속성을 포함하는 항목 식별자입니다(금액 처리에 대한 자세한 내용은 금액 섹션 참조).

{
  "cartId": "6f891edb-1e1f-48bb-b042-2cb790a0f402",
  "currency": "XAU",
  "items": [
{
      "pegasus": {
        "amount": 250
      }
    }
  ]
}

참고해주세요

각 카트 시작 요청에는 기존 품목 식별자가 하나 이상 포함되어 있어야 하므로 모든 품목 식별자는 판매자 패널의 OmniCart에 업로드해야 구매에 사용할 수 있습니다.

아이템이 반드시 실제 소모품일 필요는 없습니다. 예를 들어 기부, 일회성 구매(예: 프리미엄 티어) 또는 리소스에 대한 일시적 액세스(예: 1년 구독)가 될 수 있습니다.

카트에는 모든 유형의 품목이 포함될 수 있습니다.

오른쪽 예제에서 items 배열에는 여러 항목 식별자가 포함되어 있습니다: donation, milk, 및 premiumAccess 입니다. 이 코드는 이러한 품목 식별자가 이전에 판매자 패널 에 등록되었음을 의미합니다.

  "items": [
{
      "lich": {
        "amount": 600
        },
      "wight": {
        "amount": 230
        },
      "vampire": {
        "amount": 500
        }
      }
  ]

OmniCart는 유효한 형식의 태그만 있으면 모든 태그를 허용합니다. 원하는 경우 각 장바구니 시작 요청에 대해 다른 태그 또는 태그 집합을 사용할 수 있습니다. 태그는 회원님 측에서 생성되므로 태그의 일관성은 회원님이 직접 관리합니다.

오른쪽의 요청 스니펫에서 mage 및 naga 항목에는 tower 태그가 할당됩니다. beholder 항목에는 dungeon 태그가 표시되어 있고 nomad 항목에는 태그가 전혀 없습니다.

카트가 시작된 후에는 태그를 사용하여 장바구니 품목 상태 검색, cancel, 캡처 또는 refund 해당 API 메서드를 호출하여 품목을 확인할 수 있습니다(품목 상태에 대한 자세한 내용은 결제 수명 주기 참조).

modify 메서드를 호출하여 태그를 재정의하거나 재할당할 수도 있습니다. 이 옵션은 이 문서의 수정 섹션에 자세히 설명되어 있습니다.

    "items": [
{
        "mage": {
          "tag": "tower",
          "amount": 450
        }
      },
      {
        "naga": {
          "tag": "tower",
          "amount": 1600
        }
      },
      {
        "nomad": {
          "amount": 200
        }
      },
      {
        "beholder": {
          "tag": "dungeon",
          "amount": 280
        }
      },
    ]

일괄 설정 및 재정의

OmniCart를 사용하면 카트의 품목에 특정 결제 설정 및 타이머 설정을 일괄 적용할 수 있습니다. 이러한 설정은 전체 카트에 적용하거나 태그별로 적용할 수 있습니다. 태그 설정은 카트 설정보다 우선합니다. 특정 항목의 설정은 이 항목에 정의된 태그가 표시되어 있더라도 모든 상위 설정을 재정의합니다. 중첩된 구조 또는 계층적 상속으로 생각하면 되며, 카트가 최상위 수준입니다.

노트

항목에 태그가 할당될 수도 있고 할당되지 않을 수도 있습니다. 품목에 태그가 할당되지 않은 경우에도 해당 설정은 여전히 카트 설정보다 우선합니다.

오른쪽의 코드 예시를 살펴보세요. 카트 수준 설정은 amountMode 및 capture 속성만 정의합니다.

태그 설정은 amountMode 을 상속하고 capture 속성을 재정의하며 추가 캡처 설정을 정의합니다.

항목 설정은 상위 amountMode 및 autoAction 속성을 재정의하고 해당 특정 항목에 대한 amountModifier 속성을 추가합니다. 다른 설정은 상속됩니다.

전설
  //한정되지 않은
  //새롭게 정의된
  //부모로부터 상속받음
  //자식에 의해 재정의됨

카트
꼬리표
목

      "amountMode": "declared", 
      "amountModifier": null,
      "capture": false,
      "captureSettings": {
        "autoAction": null,
        "value": null
},
      "enableTimer": null,
      "timer": {
        "triggerEvent": null,
        "value": null
}

      "amountMode": "declared",
      "amountModifier": null,
      "capture": true,
      "captureSettings": {
        "autoAction": "cancel",
        "value": 172800
},
      "enableTimer": null,
      "timer": {
        "triggerEvent": null,
        "value": null
}

      "amountMode": "calculated",
      "amountModifier": 0.7,
      "capture": true,
      "captureSettings": {
        "autoAction": "complete",
        "value": 172800
},
      "enableTimer": null,
      "timer": {
        "triggerEvent": null,
        "value": null
}

참고해주세요

실제 요청에서는 원하는 만큼 태그를 정의하거나 정의하지 않고 항목에 할당할 수 있습니다.

태그를 정의하고 항목에 할당하지 않으면 정의된 태그가 요청 결과에 실질적인 영향을 미치지 않더라도 장바구니 시작 요청은 OmniCart에서 승인됩니다.
마찬가지로 정의되지 않은 태그를 항목에 할당해도 오류로 간주되지 않습니다.

카트에 있는 항목​

태그​

일괄 설정 및 재정의​

카트에 있는 항목

태그

일괄 설정 및 재정의