Checkout•

checkout 생성

checkout 생성에 관련된 키/값 쌍을 탐색합니다.

이 API 엔드포인트는 고객의 장바구니에서 장바구니 정보와 항목을 Zonos API로 전송하는 데 사용됩니다.

당신은 Zonos 시스템에서 고유한 장바구니 식별자인 tempCartUUID를 포함하는 JSON 응답을 받게 됩니다. 이는 고객을 Zonos Checkout로 리디렉션하여 주문을 완료하는 데 사용됩니다.

속성

요청 본문의 JSON 키/값 쌍

POST https://api.iglobalstores.com/v1/createTempCart

필드	비고
`boxCount`	예시 값: 22x15x15(1),8x8x4(2),32x22x14(1) 형식: 쉼표로 구분된 상자 치수 및 수량 목록. 위의 예에서 총 4개의 상자가 있습니다. 목록의 첫 번째 상자는 길이 22인치, 너비 15인치, 높이 15인치입니다. 해당 크기의 상자는 하나만 사용됩니다. 크기가 8x8x4인 상자가 두 개 있습니다. 같은 상자 치수를 여러 번 전달하는 것도 허용됩니다. 예를 들어 “22x15x15(1),22x15x15(1)”와 같이 전달할 수 있으며, 이는 22x15x15인치 크기의 상자가 2개임을 의미합니다. 이 필드는 주문을 배송하는 데 사용될 상자를 설명합니다. 상점 주인이 주문 시 이를 알 필요는 없지만, 알고 있다면 `string` 형식으로 전달할 수 있습니다.
`contShoppingURL`	이 필드는 Zonos Checkout 내의 “계속 쇼핑” 버튼의 HREF를 재정의하기 위해 URL을 전달하는 데 사용됩니다. `string`
`domesticShippingCharge`	이 필드는 Zonos Checkout에 국내 배송 요금을 전달하는 데 사용되며, 해당 금액은 배송비에 추가됩니다. 배송 총액을 추가하거나 별도의 항목으로 나눌 수 있도록 구성할 수 있습니다. `양수 부동 소수점, 소수점 두 자리`
`externalConfirmationPageURL`	이 필드는 주문 확인/감사 페이지의 URL을 전달하는 데 사용됩니다. 고객이 Zonos Checkout 내에서 결제를 완료한 후, 이 URL로 리디렉션되어 주문 확인을 받게 됩니다. 이 URL은 종종 Zonos의 “orderDetail” API 서비스 엔드포인트를 호출하여 주문 세부 정보를 검색하고 시스템에 주문을 가져오는 데 사용됩니다. `string`
`footerHTML`	이 필드는 URL 인코딩된 HTML 문자열을 전달하는 데 사용됩니다. 이 HTML 문자열은 디코딩되어 checkout 페이지의 닫는 body 태그 앞에 배치됩니다. 일반적으로 재마케팅, 분석 등을 위한 코드를 전달하는 데 사용됩니다. `URL 인코딩된 문자열`
`items` 필수	이 필드는 항목 맵의 목록입니다. `JSON 문자열`
`items[index].countryOfOrigin`	이 필드는 항목의 원산지 국가를 전달하는 데 사용됩니다. 매개변수는 두 글자 ISO 코드여야 합니다. `string`
`items[index].description` 필수	이 필드는 장바구니 항목의 전체 설명을 전달하는 데 사용되며, 항목 옵션, 색상 등을 포함합니다. `string`
`items[index].height`	이 필드는 항목의 높이를 전달하는 데 사용되며, 정확한 배송 견적을 위해 강력히 권장됩니다. 높이 단위는 필수 로 인치입니다. `string - 양수 부동 소수점, 소수점 두 자리 / 정수 (인치)`
`items[index].imageURL` 필수	이 필드는 항목 제품 이미지의 URL을 전달하는 데 사용됩니다. URL은 Zonos Checkout 내에서 표시되기 위해 HTTPS여야 합니다. `string / HTTPS URL`
`items[index]itemBrand`	이 필드는 항목 브랜드를 전달하는 데 사용됩니다. `string`
`items[index]itemCategory`	이 필드는 항목 카테고리를 전달하는 데 사용되며, 항목이 여러 카테고리를 가진 경우 파이프로 구분하여 전달할 수 있습니다. 예시 값: “shoes” 또는 “shoes\|sport-shoes\|discount-shoes”`string`
`items[index]itemCustomization`	이 필드는 Zonos Checkout에 표시되지 않는 항목에 대한 추가 세부정보를 전달하는 데 사용됩니다. 그러나 이는 “orderDetail” API 서비스 엔드포인트를 통해 검색할 수 있습니다.
`items[index]itemHSCode`	이 필드는 항목 HS 코드를 전달하는 데 사용되며, 마침표가 있을 수도 있고 없을 수도 있습니다. 예시 값: “3926901000” 또는 “3926.90.1000”`string`
`items[index].itemURL`	이 필드는 항목 제품 페이지의 URL을 전달하는 데 사용됩니다. `string / URL`
`items[index].length`	이 필드는 항목 길이를 전달하는 데 사용되며, 정확한 배송 견적을 위해 강력히 권장됩니다. 길이 단위는 필수 로 인치 단위입니다. `string - 양수 부동 소수점, 소수점 두 자리 / 정수 (인치)`
`items[index].nonShippable`	이 필드는 항목이 배송, 세금 및 관세 계산에 포함되어야 하는지를 나타내는 데 사용됩니다. 디지털 다운로드, 할인 코드, 처리 수수료 등은 “true” 값으로 전달해야 합니다. `boolean: true 또는 false`
`items[index].productId`	이 필드는 라인 항목 수량을 전달하는 데 사용됩니다. `string`
`items[index].quantity` 필수	이 필드는 라인 항목 수량을 전달하는 데 사용됩니다. `string`
`items[index].sku`	이 필드는 항목 SKU / UPC / 등을 전달하는 데 사용됩니다. `string`
`items[index].unitPrice` 필수	이 필드는 라인 항목 단가를 전달하는 데 사용됩니다. `양수 부동 소수점, 소수점 두 자리 / 정수`
`items[index].weight`	이 필드는 항목 무게를 전달하는 데 사용되며, 정확한 배송 견적을 위해 강력히 권장됩니다. 무게 단위는 다른 무게 단위가 `items[index].itemWeightUnits`에 전달되지 않는 한 기본적으로 “LBS”로 설정됩니다.`string - 양수 부동 소수점, 소수점 두 자리 / 정수`
`items[index].weightUnits`	이 필드는 기본 항목 무게 단위를 재정의하는 데 사용됩니다. 항목 무게 단위는 이 필드에 다른 무게 단위가 전달되지 않는 한 기본적으로 “LBS”로 설정됩니다. `string - "LB", "OZ", "KG", 또는 "G”`
`items[index].width`	이 필드는 항목 너비를 전달하는 데 사용되며, 정확한 배송 견적을 위해 강력히 권장됩니다. 너비 단위는 필수 로 인치 단위입니다. `string - 양수 부동 소수점, 소수점 두 자리 / 정수 (인치)`
`misc1 - misc6`	이 필드는 Zonos API를 통해 주문과 관련된 기타 데이터를 전달하는 데 사용되며, 이는 Zonos “orderDetail” API 서비스 엔드포인트에서 반환된 주문 데이터와 함께 검색됩니다. `string`
`referenceId`	이 필드는 시스템 내 장바구니/세션/etc.에 대한 고유 참조 식별 값을 전달하는 데 사용됩니다. 이는 Zonos “orderDetail” API 서비스 엔드포인트를 통해 Zonos 주문 ID를 조회하는 데 사용될 수 있습니다. `string`
`storeId` 필수	Zonos에서 제공하는 상점 ID입니다. `integer`

추가 문자열 데이터 유형

items[index].itemDescriptionLong
items[index].itemDescriptionDetailed
items[index].itemFabricContent
items[index].itemColor
items[index].itemLtlClass
items[index].status
items[index].itemMaterial

할인, 쿠폰 및 프로모션 코드

할인, 쿠폰 및 프로모션 코드를 Zonos에 서버 포스트를 통해 전송하려면, 별도의 항목으로 전달해야 하며, 매개변수: “unitPrice” 및 “nonShippable”:true에 대해 음수 값을 사용해야 합니다.

예시 할인 항목 맵

{
  "description": "Discount (10OFF) - 10% OFF",
  "unitPrice": -15.5,
  "quantity": 1,
  "nonShippable": true
}

HTTPS 응답

성공 HTTP 응답

메시지 형식: JSON

예제 성공 응답

{
  "tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"
}

응답 JSON 정의

필드	비고
`tempCartUUID`	이 매개변수는 고객의 국제 장바구니에 할당된 GUID를 포함하며 Zonos 시스템에서 생성됩니다. 이 필드는 사용자의 브라우저를 Zonos Checkout로 리디렉션할 때 URL 쿼리 `string` 매개변수를 통해 전달됩니다.

오류 HTTP 응답

오류 코드	의미
400	요청 본문에 예기치 않은 문자가 있습니다.
406	허용되지 않음. “Accept”에 대한 HTTP 헤더가 유효하지 않습니다.
415	지원되지 않는 미디어 유형. “Content-Type”에 대한 HTTP 헤더가 유효하지 않습니다.
422	처리할 수 없는 엔터티입니다.
500	“storeId”가 잘못되었거나 JSON 본문을 구문 분석할 수 없습니다.

예제 오류 응답

<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
    <title>Error 422 Unprocessable Entity</title>
  </head>
  <body>
    <h2>HTTP ERROR 422</h2>
    <p>
      Problem accessing /v2/createTempCart. Reason:
      <pre>Unprocessable Entity</pre>
    </p>
    <h2>The request entity had the following errors:</h2>
    <ul>
      <li>items may not be empty (was null)</li>
      <li>items may not be null (was null)</li>
    </ul>
  </body>
</html>

Zonos Checkout로 리디렉션

tempCartUUID를 포함한 성공적인 응답을 받은 후, 귀하의 서버는 고객의 브라우저에서 Zonos Checkout로 적절한 URL 쿼리 문자열 매개변수를 포함하여 리디렉션을 보냅니다.

예시 리디렉션 URL: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

참고: [yourassignedsubdomain] - 귀하의 Zonos 구현 팀원에게 연락하여 귀하의 Zonos.com 서브도메인을 받으십시오.

URL 요청 매개변수

필드 비고

필드	비고
`tempCartUUID` 필수	이 값은 Zonos `createTempCart` API 서비스 엔드포인트를 호출하여 얻습니다. `string / GUID`
`country`	목적지 국가의 두 글자 ISO 코드. 사용자 경험을 위해 이 매개변수를 전달하는 것을 강력히 권장합니다. `country` 매개변수는 Zonos Checkout 내에서 목적지 국가를 미리 선택합니다. 사이트에서 Zonos Hello JS (JavaScript)를 사용할 때, 이 값을 얻으려면 JavaScript 메서드: `zonos.country()`를 호출하면 됩니다. `string` (길이: 2)

tempCartUUID

필수

이 값은 Zonos createTempCart API 서비스 엔드포인트를 호출하여 얻습니다. string / GUID

country 목적지 국가의 두 글자 ISO 코드. 사용자 경험을 위해 이 매개변수를 전달하는 것을 강력히 권장합니다. country 매개변수는 Zonos Checkout 내에서 목적지 국가를 미리 선택합니다. 사이트에서 Zonos Hello JS (JavaScript)를 사용할 때, 이 값을 얻으려면 JavaScript 메서드: zonos.country()를 호출하면 됩니다. string (길이: 2)

추가 문자열 데이터 유형

customerName
customerCompany
customerEmail
customerPhone
customerAltPhone
customerAddress1
customerAddress2
customerCity
customerState
customerZip

이 페이지가 도움이 되었습니까?

질문 있으세요?

문의하세요.

Zonos을 보세요

정책 및 계약