이 페이지는 Cloud Translation API를 통해 번역되었습니다.

현금 결제 방법

개요

Google Standard Payments는 편의점 (예: 세븐일레븐) 구매와 같은 현금 기반 FOP (결제 방법)를 지원합니다. 개괄적으로 보면 상품 비용을 지불하려는 사용자가 결제 통합업체를 통해 참조 번호를 생성합니다. 그런 다음 사용자는 이 참조 번호를 편의점, 키오스크, 은행으로 가져가서 참조 번호를 결제합니다.

개념 및 용어

기호 및 규정

이러한 문서의 '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은 다음 두 가지 주요 절차를 사용하여 이러한 참조 번호를 생성하고 지불합니다.

참조 번호 흐름 생성
결제 참조 번호 흐름

나중에는 구매 후 조정과 정산이 송금 흐름에 따라 처리됩니다.

아래의 다이어그램은 이러한 각 흐름을 보여줍니다.

현금 FOP 개요

처음 두 흐름은 다음 섹션에서 더 자세히 설명합니다. 송금 절차에 대해 자세히 알아보려면 송금 과정 페이지를 참조하세요.

참조 번호 생성

참조 번호 생성 흐름의 목적은 Google과 통합업체가 모두 구매를 식별하는 데 사용할 수 있는 식별자 (참조 번호)를 만들고 교환하는 것입니다. 사용자는 편의점, 키오스크, 은행에서 이 참조 번호를 사용하여 구매를 완료할 수 있습니다. 이 식별자는 generateReferenceNumber 메서드를 호출하여 Google의 요청에 따라 통합자가 생성합니다. 참조 번호 생성 요청에는 금액과 거래 설명이 포함됩니다.

다음 다이어그램은 참조 번호가 생성되어 고객에게 안내와 함께 전송되는 방법을 보여줍니다.

참조 번호 생성 절차

현금 생성 참조 번호

객체의 목록과 각 객체가 나타내는 항목은 다음과 같습니다.

사용자: 이 결제 방법으로 결제하려는 사람입니다.
Google UI: 사용자가 구매하는 인터페이스입니다. 웹이나 앱을 통해 이루어질 수 있습니다.
Google 서버: 참조 번호 생성을 요청하고 사용자를 위한 결제 안내를 만드는 Google의 백엔드 서버입니다.
결제 통합업체 서버: 결제 세부정보를 추적하고 참조 번호를 생성하는 결제 통합업체의 백엔드 서버입니다.

이 과정은 현금 결제 수단을 사용하려는 사용자로부터 시작됩니다.

사용자가 Google UI에 액세스하여 참조 번호 요청을 전송합니다.
Google UI는 참조 번호 (getReferenceNumber)가 필요하다는 메시지를 Google 서버에 전송합니다.
Google 서버에서 결제 통합업체 서버에 참조 번호 (generateReferenceNumber)를 생성하도록 요청합니다.
결제 통합업체 서버에서 참조 번호를 생성하여 Google 서버에 전송합니다.
Google 서버에서는 참조 번호와 함께 결제 안내를 만듭니다. 그런 다음 이 정보를 Google UI로 전송합니다.
Google UI에서 이러한 안내와 참조 번호를 사용자에게 전송합니다.

참조 번호 관련 참고사항

참조 번호는 한 번만 결제할 수 있으며, 참조 번호 취소 절차를 통해 취소할 수 있습니다. 또한 참조 번호는 영숫자여야 하며 다양한 표시 형식을 지원해야 합니다.

Google UI에서는 참조 번호를 표시하는 것 외에도 원하는 경우 참조 번호를 Code 128 형식 (바코드 형식)으로 표시할 수 있습니다. 요청 시 다른 바코드 형식이 지원됩니다.

결제 참조 번호

사용자는 편의점, 키오스크, 은행에서 이 참조 번호를 사용하여 결제하려는 구매를 식별합니다. 통합업체는 사용자에게 결제하기 전에 구매 금액, 날짜, 거래 설명을 표시하여 결제가 진행되고 있음을 확인하도록 해야 합니다.

사용자가 결제를 선택하면 전액 결제해야 하며 한 번만 결제해야 합니다. 이 API는 단일 참조 번호에 대한 초과 또는 미달 결제를 지원하지 않습니다. 하나의 참조 번호로 여러 번 결제할 수도 없습니다.

사용자가 결제하면 통합업체는 이 참조 번호가 referenceNumberPaidNotification 메서드를 통해 결제되었음을 즉시 Google에 알려야 합니다. 사용자가 실제로 결제한 후 몇 초 내에 이 메서드를 호출함으로써 통합업체는 사용자가 신속하게 물품을 수령할 수 있게 해줍니다. (네트워크가 다운되면 이 호출을 대기열에 추가할 수 있습니다.)

결제되면 참조 번호와 금액이 T+2일에 전송된 송금 명세서에 포함됩니다.

다음은 참조 번호의 결제를 보여주는 시퀀스 다이어그램입니다.

결제 참조 번호 절차

다이어그램의 객체는 다음을 나타냅니다.

사용자: 이 결제 방법으로 결제하려는 사람입니다.
편의점: 사용자가 참조 번호와 제공된 안내를 사용하여 결제하는 장소(예: 편의점)입니다.
결제 통합업체 서버: 결제 세부정보를 추적하는 결제 통합업체의 백엔드 서버입니다.
Google 서버: 참조 번호 생성을 요청하고 사용자를 위한 결제 안내를 만드는 Google의 백엔드 서버입니다.

이 흐름은 사용자가 제공된 지침에 따라 결제를 위해 편의점에 가는 것부터 시작됩니다.

사용자가 편의점에서 결제를 합니다.
거래가 완료되면 편의점에서 결제 통합업체에 결제를 알립니다.
결제 통합업체 서버가 편의점에 성공 메시지를 보냅니다.
편의점은 사용자에게 거래가 성공했음을 알리고 상품이 곧 사용자에게 배송될 것입니다.
결제 통합업체 서버에서 참조 번호가 결제되었다는 메시지 (referenceNumberPaidNotification)를 Google 서버에 전송합니다. 이 단계는 4단계를 차단해서는 안 됩니다.
Google 서버가 결제 통합업체 서버에 성공 메시지를 보냅니다.

참조 번호 취소

Google에서 참조번호를 취소할 수 있습니다. Google에서 참조 번호를 취소하면 cancelReferenceNumber 메서드가 호출됩니다. 통화가 성공적으로 회신될 경우 해당 참조 번호를 지불할 수 없으며 통합업체는 해당 번호에 대한 결제를 거부해야 합니다. 호출이 성공하면 referenceNumberPaidNotification에 대한 모든 향후 호출이 실패합니다.

결제 프로세스가 이미 시작된 경우, 예를 들어 사용자가 키오스크에 참조 번호를 입력했지만 아직 결제하지 않은 경우 통합업체는 USER_ACTION_IN_PROGRESS가 포함된 ErrorResponse와 함께 HTTP 423 응답 코드를 반환해야 합니다.

다음: 송금 과정