리디렉션 결제는 다음과 같은 두 가지 방법으로 시작할 수 있습니다.
사용자가 '결제 리디렉션'을 선택하면 사용할 결제 수단 (FOP)을 선택할 수 있도록 통합업체의 웹사이트로 리디렉션됩니다. 이 경우 요청에
noFopChosen가 채워집니다. 이 경우 통합업체는 사용자에게 사용 가능한 발급기관 목록을 표시합니다. 사용자가 이러한 옵션 중 하나를 선택하면 구매를 완료할 수 있도록 해당 발급기관의 웹사이트/앱으로 사용자가 전달됩니다.사용자는 구매 흐름 중에 FOP (발급기관)를 선택합니다. 이 경우 Google은 요청에
issuerId매개변수를 채우고 사용자를 통합업체로 리디렉션합니다. 통합업체는 이 코드를 수신하면 즉시 사용자를 발급기관의 웹사이트/앱으로 리디렉션하여 구매를 완료해야 합니다.
위의 두 경우 모두 Google은 이전에 Google의 서버 간 호출 없이 사용자를 통합업체의 웹사이트로 직접 리디렉션합니다.
통합업체는 GET을 사용하여 HTTPS 프로토콜을 구현해야 합니다. 리디렉션 요청 매개변수에 설명된 GET 매개변수에는 요청된 리디렉션 결제에 대한 정보가 포함됩니다.
통합업체는 2,048자(영문 기준)의 URL 길이를 지원해야 합니다. 여기에는 스키마, 호스트, 포트, 경로, 매개변수가 포함됩니다. 모든 매개변수는 URL 인코딩 전에 UTF-8로 인코딩됩니다.
리디렉션 요청
다음은 리디렉션 시작 흐름 (리디렉션 요청이라고도 함)의 일부로 사용자가 리디렉션되는 URL의 예입니다.
https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H
이 예에서 URL 디코딩된 callbackUrl 매개변수의 값은 다음과 같습니다.
https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE
redirectRequest 매개변수는 base64url로 인코딩되기 전에 PGP 또는 JWE+JWS를 사용하여 암호화되고 서명됩니다.
리디렉션 요청 매개변수
HTTPS GET 요청에는 다음과 같은 쿼리 매개변수가 있어야 합니다.
| 필드 | |
|---|---|
callbackUrl
|
string
결제가 완료되면 사용자를 리디렉션하는 URL입니다. 이 값은 URL로 인코딩되며 최대 길이는 512자(영문 기준)입니다.
이 URL은 |
redirectRequest
|
RedirectRequest
필수: |