자동 할인 설정하기

가격 토큰을 구현하려면 다음 안내를 따르세요.

토큰 구조

JWT 토큰에는 2가지 JSON 객체(헤더 및 페이로드)가 포함됩니다.

헤더

---

{

"alg": "ES256",

"typ": "JWT"

}

---

Google에서 생성한 토큰 헤더에는 2가지 필드가 있습니다.

• alg - 사용한 알고리즘이며 값은 항상 'ES256'입니다.
• typ - 미디어 유형이며 값은 항상 'JWT'입니다.

토큰 헤더에 다른 필드가 포함되거나 필드 값이 위에 설명된 것과 다르다면 해당 토큰을 거부해야 합니다.

페이로드

---

{

"exp": 1571673600,

"o": "tddy123uk",

"m": "140301646",

"p": 21.99,

"c": "USD"

}

---

페이로드에는 다음 필드가 있습니다.

• exp - Unix 시간에 따른 만료 시간입니다. 토큰이 만료된 경우 거부해야 합니다.
• o - 쿠폰 ID로, 방문 페이지가 제품과 일치하는지 확인하는 데 사용할 수 있습니다. 일치하지 않는 경우 토큰을 거부해야 합니다.
• m - 판매자 ID입니다. 판매자 ID가 일치하지 않으면 토큰을 거부해야 합니다.
• p - 할인된 가격
• c - 통화, 대문자

토큰 사용

토큰을 사용하는 방법에 대한 정확한 세부정보는 사용된 라이브러리에 따라 다르지만, 일반적으로 디코딩 및 서명 유효성 검사, 필드 유효성 검사, 가격 사용의 3가지 단계로 구성됩니다.

디코딩 및 서명 유효성 검사 Base64URL로 인코딩된 토큰은 pv2 URL 요청 파라미터로 전달됩니다.

대부분의 라이브러리는 '토큰', 'ES256'(알고리즘), '공개 키'는 입력이고 'token_body'는 출력인 단일 함수에 디코딩 및 서명 유효성 검사를 결합합니다.

유효성 검사를 위한 공개 키:

다음 키는 만료일이 없으며 모든 자동 할인 사용자가 사용할 수 있도록 제공됩니다.

필드 유효성 검사

선택한 라이브러리가 이전 단계에서 키 및 알고리즘을 수락하여 헤더 옵션에도 불구하고 이를 강제로 사용하는 경우, 추가 헤더 검사가 필요하지 않습니다. 그렇지 않은 경우에는 위의 가이드라인에 따라 헤더 필드를 검사해야 합니다. 자세한 내용은 JSON 웹 토큰 최신 권장사항을 참고하세요.

어떤 라이브러리를 사용하든 판매자 측 데이터를 기준으로 o, m, p 필드의 유효성 검사가 이루어져야 합니다. 일치하지 않는 경우 고객이 제품 또는 판매자 간에 토큰을 복사할 수 없도록 토큰을 거부해야 합니다. 판매자는 exp 필드를 확인하여 토큰이 만료된 경우 거부할 수 있지만 필수는 아닙니다.

가격 사용 모든 필드가 유효하고 토큰이 만료되지 않았다면 판매자는 p 필드에 제공된 가격을 사용해야 합니다.

이 페이지에 나온 요구사항을 충족하는 경우 기존 쿠폰 기능을 사용하여 가격을 할인할 수 있습니다. 특히 방문 페이지의 가격과 토큰의 가격이 일치해야 합니다. 결제 페이지에 할인 금액을 추가하는 것만으로는 충분하지 않습니다.

테스트 통합이 완료되면 3단계 테스트가 진행됩니다.

• 기능 테스트(판매자가 진행)
• 키 유효성 검사(Google에서 제공한 토큰으로 판매자가 진행)
• 전체 엔드 투 엔드 테스트(Google에서 진행)

기능 테스트 개발 중 및 개발 후에 테스트를 수행하는 가장 쉬운 방법은 임시 키 쌍을 생성하는 것입니다. 이렇게 하면 토큰을 완전히 제어할 수 있습니다. 다음 명령어로 유효한 키 쌍을 생성할 수 있습니다.

토큰은 jwt.io 또는 ES256을 알고리즘으로 사용하는 유사한 도구로 생성할 수 있습니다.

키 유효성 검사 프로덕션 키가 올바르게 구성되었는지 확인하기 위해, 서명된 토큰을 온보딩 중에 판매자 센터에서 사용할 수 있습니다(샘플 URL).