FOP 리디렉션
개요
Google Standard Payments는 리디렉션 기반의 결제 수단 (FOP)을 지원합니다. 리디렉션 FOP를 사용하면 Google 제품 또는 서비스 사용자가 외부 법인의 웹 인터페이스에서 해당 제품 또는 서비스의 비용을 결제할 수 있습니다. 개략적으로 설명하자면, 제품 비용을 지불하려는 사용자는 처음에 결제 통합업체 또는 결제 통합업체를 통해 이용 가능한 발급기관으로 리디렉션됩니다. 사용자가 통합업체로 리디렉션되는 경우 통합업체는 구매를 완료하기 위해 사용자를 발급기관의 웹 인터페이스로 전달해야 합니다. 결제가 완료되면 사용자는 통합업체를 통해 Google로 다시 리디렉션됩니다.
Google은 다음 두 가지 기본 절차를 사용하여 리디렉션 FOP 결제를 완료합니다.
- 리디렉션 시작: 리디렉션 결제를 시작할 수 있는 두 가지 흐름이 있습니다. 결제 통합업체는 다음 옵션 중 하나만 구현해야 합니다.
- 리디렉션 절차 시작: 사용자를 결제 통합업체로 리디렉션하여 결제를 시작합니다.
- 리디렉션 결제 URL 생성 흐름: Google은 결제 통합업체에 서버 간 요청을 전송하여 결제 리디렉션 URL을 생성하는 방식으로 결제를 시작합니다. 이 응답에 따라 Google에서 사용자를 발급기관으로 직접 리디렉션합니다.
- 리디렉션 흐름 완료: 사용자가 구매를 완료하면 통합업체는 이 절차를 사용하여 Google을 통한 결제를 확인합니다.
마지막으로 통합업체 은행과 Google 은행 간의 모든 자금 이동은 송금 흐름을 통해 이루어집니다.
FOP 리디렉션 개요
다음 그림은 대략적인 흐름의 개요를 보여줍니다.
개략적으로 Google 제품에 서비스를 결제 수단으로 추가하려면 다음 절차를 따르세요.
- 리디렉션 시작:
- 리디렉션 흐름 완료
- 환불 절차
- 송금 흐름
개념 및 용어
e기호 및 규정
이러한 문서의 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'MAY' 및 'OPTIONAL'은(는) RFC 2119에 설명된 대로 해석되어야 합니다.
타임스탬프
모든 타임스탬프는 Unix 에포크 (1970년 1월 1일) 이후 UTC 기준으로 표시됩니다.
예를 들면 다음과 같습니다.
- 2019년 4월 23일, 오후 8:23:25 GMT = 1556051005000밀리초
- 2018년 8월 16일, 오후 12:28:35 GMT = 1534422515000밀리초
금액
이 API의 금전적 값은 Google의 표준인 '마이크로'라는 형식으로 되어 있습니다. 마이크로는 정수 기반의 고정 정밀도 형식입니다. 마이크로 단위로 금액을 나타내려면 표준 통화 값에 1,000,000을 곱합니다.
예를 들면 다음과 같습니다.
- 1.23달러 = 1230,000마이크로달러
- 미화 0.01달러 = 10,000마이크로 미화
멱등성
이 API 내의 모든 메서드 호출에는 멱등성이 있는 동작이 있어야 합니다. Google은 양측의 트랜잭션이 동일한 상태인지 확인하기 위해 간헐적으로 요청을 재시도합니다. 통합업체는 이미 성공적으로 처리된 요청을 다시 처리하려고 시도해서는 안 됩니다. 대신 성공적인 처리에 대한 응답이 보고되어야 합니다. 모든 메서드에는 requestId가 포함된 공통 RequestHeader가 있습니다. 이 requestId는 모든 호출에 대한 멱등성 키입니다.
비 터미널 응답 (HTTP 200 성공 아님)은 멱등적으로 처리되어서는 안 됩니다. 따라서 이전에 400 (잘못된 요청/실패한 전제조건)을 받은 요청은 두 번째 호출 시 멱등적으로 400을 반환해서는 안 되며 다시 평가해야 합니다. 재평가 시 400이 반환되거나 성공적으로 처리될 수 있습니다.
멱등성에 관한 자세한 내용은 이 상세 가이드를 참고하세요.
통합자
비즈니스를 위해 Google의 결제 플랫폼을 사용하는 회사입니다. YouTube나 애드워즈와 같은 내부 (1P)일 수도 있고, Google의 생태계와 작동하도록 서비스를 통합하려는 외부 (3P) 비즈니스일 수도 있습니다.
결제 방법
결제 수단. 악기보다 더 일반적입니다. Visa, MasterCard, PayPal은 모두 결제 수단입니다.
결제수단
특정 고객에 의한 특정 결제 수단 인스턴스입니다. 사용자의 신용카드나 PayPal 계정을 예로 들 수 있습니다. 특정 고객에 대한 토큰화된 FOP는 Google 시스템에 안전하게 저장된 고객의 결제 수단 인스턴스이므로 결제 수단이기도 합니다.
토큰
Google 시스템에서 특정 사용자의 결제 수단을 나타냅니다. 토큰은 구매에 필요한 모든 정보를 담고 있으므로 도구이기도 합니다. 여기에는 사용자가 통합업체에 가지고 있는 계좌 번호와 같은 정보가 포함될 수 있습니다.
주요 흐름
리디렉션 단계 시작
리디렉션 결제의 첫 번째 단계는 리디렉션 시작입니다. 리디렉션 시작 절차의 목적은 통합업체를 통해 선택한 발급기관의 웹 인터페이스로 사용자를 리디렉션하여 사용자가 결제를 승인할 수 있도록 하는 것입니다. 리디렉션 시 Google은 통합업체에 기본 거래 정보를 제공하고 통합업체는 해당 정보를 발급기관에 전달합니다.
자세한 내용은 리디렉션 흐름 시작 섹션을 참고하세요.
리디렉션 흐름 완료
사용자가 발급기관의 웹 인터페이스로 이동한 후 결제를 완료하는 데 필요한 모든 단계를 수행해야 합니다 (이 단계는 발급기관에 따라 다를 수 있음). 리디렉션 완료 절차의 일환으로 발급기관은 결제 완료에 관한 정보를 포함하여 사용자를 통합업체로 다시 리디렉션해야 합니다. 그런 다음 통합업체는 리디렉션 응답의 일부로 결제 세부정보를 포함하여 사용자를 다시 Google로 리디렉션합니다. 결제가 확인되면 Google은 구매 상품 또는 서비스를 사용자에게 제공합니다.
자세한 내용은 리디렉션 과정 완료 섹션을 참고하세요.