이동통신사용 Google 표준 결제 소개

Google 표준 결제 환경에서 이동통신사 결제는 토큰화된 결제 수단 (FOP)으로 간주됩니다. 즉, Google과 결제 통합업체는 토큰을 설정하기 위해 계정 ID 사용자 인증 정보의 일회성 교환을 수행합니다. 나중에 청구할 계정을 식별하기 위해 이 토큰이 결제 통합업체에 제공됩니다.

다른 결제 수단도 토큰화를 사용하므로 대부분 이동통신사 결제와 관련된 토큰화된 FOP에 대한 일반적인 개요를 제공합니다. 인증, 연결, 구매, 송금 흐름은 이 개요에서 모두 자세히 설명되어 있습니다. 이 페이지에서는 이동통신사 결제와 관련된 내용을 자세히 설명합니다.

이동통신사는 다음 흐름을 구성하는 API를 구현하여 Google Standard Payments에 온보딩합니다.

흐름	설명	DCB3 사양 해당
인증	DCB 결제에 사용될 결제 통합업체 시스템의 사용자 계정을 식별하고 인증합니다.	GoogleUserToken을 사용한 SMS-MO
연결	Google과 결제 통합업체가 사용자의 결제 통합업체 계정을 사용하여 결제하는 데 사용할 수 있는 장기 토큰을 교환합니다.	OperatorUserToken 및 GetProvisioning()을 사용한 승인 사용자 콜백
FundsTransfer	동기식으로 사용자의 결제 통합업체 계정 외부로 자금을 이동합니다. 결제 통합업체로 책임 이전	일괄 요청 파일의 Auth() 및 CHARGE 라인
환불	이전 자금 이체에 연결된 자금의 일부 또는 전부를 동기식으로 사용자의 결제 통합업체 계정으로 반환합니다. Google에 책임 이전	일괄 요청 파일의 환불 줄
송금	API 기반 정산(일 단위로 지급 권장)	월별 인보이스 PDF, 월별 인보이스 세부정보 파일, 일일 리콘 파일
UpdateAssociatedAccount	사용자의 결제 통합업체 계정 변경사항 (예: 거래 한도 또는 프로비저닝 상태)을 Google에 알립니다.	GetProvisioning() 설문조사
사기	사용자 이의 제기로 인해 취소된 거래에 대해 Google에 알립니다. 이는 Google의 위험 관리 엔진을 개선하는 데 사용되지만 금전 배상책임에는 영향을 미치지 않습니다	없음

DCB3 사양과의 전반적인 비교

Google 표준 결제 사양은 DCB3 사양으로 해결하는 것과 동일한 문제를 해결합니다. 그러나 솔루션을 개선하는 다양한 기술과 API 설계를 사용합니다. 주요 차이점은 다음과 같습니다.

스택 기술 비교

모든 API 통신은 PGP 암호화 및 서명된 JSON이 포함된 HTTPS POST를 사용하여 이루어집니다. 즉, Google과 결제 통합업체에는 각각 순환할 PGP 키가 하나만 있습니다. 또한 이러한 기술은 SOAP보다 더 나은 지원을 제공합니다. 통신 스택에 관한 자세한 내용은 여기를 참고하세요.

API 철학 비교

DCB3는 결제 상태를 조정하는 데 파일에 크게 의존합니다. Google Standard Payments에는 파일이 없습니다. API 호출은 최종 상태가 확인될 때까지 멱등적으로 무기한으로 재시도됩니다.

최종 상태는 특정 멱등성 키에 대해 실제로 최종 상태입니다. 버그 및 미확정 상태는 거부가 아닌 200이 아닌 HTTP 응답으로 모델링됩니다. 이렇게 하면 버그를 더 빠르게 포착하고 거부로 마스킹되는 것을 방지할 수 있습니다.

새로운 기능

Google 표준 결제는 다음과 같은 새로운 기능을 지원합니다.

• 사기범을 Google 위험 엔진에 알리는 Fraud API
• Associated Account API를 업데이트하여 프로비저닝, 거래 한도, 계정 상태 변경사항을 Google에 알립니다.
• USSD PIN과 같은 구매 중 인증 챌린지 지원 추가
• 일일 송금 주기

DCB3 - Google 표준 결제 용어 지도

이 문서와 사양 자체에서 사용되는 용어를 확인할 수 있지만 실제로는 기존 개념에 다른 단어가 될 수 있습니다.

• 이동통신사 -> 결제 통합업체

경고: DCB 통합업체 개념과 혼동을 피하기 위해 이 문서에서는 단순히 '통합업체'가 아닌 '결제 통합업체' 및 'DCB 통합업체'를 사용합니다. 하지만 일반적인 Google Standard Payments 문서에서는 '통합업체'를 '결제 통합업체'의 약어로 자유롭게 사용합니다.

• 결제 계약 ID -> 결제 통합업체 계정 ID
• OperatorUserToken (OUT) -> GooglePaymentToken (GPT)
• correlation_id -> requestId
• 수익 공유 -> 수수료

인증 흐름

토큰화된 FOP의 인증 흐름에 대한 일반적인 개요는 이 페이지를 참조하세요.

이동통신사 결제 관련 세부사항

이동통신사 결제의 경우 인증 흐름의 목표는 사용자가 이동통신사 계정에 연결된 SIM 카드를 제어할 수 있음을 증명하는 것입니다. 이동통신사 결제 사용자는 다음 세 가지 메커니즘 중 하나를 사용하여 인증할 수 있습니다.

• SMS-MO 인증(토큰화된 FOP 개요의 정의)
• 리디렉션 인증(토큰화된 FOP 개요의 정의)
• SMS-MT OTP(토큰화된 FOP의 정의)

결제 통합업체는 Google과 협력하여 제품에 가장 적합한 인증 메커니즘을 선택할 수 있습니다.

DCB3와 비교

인증 흐름은 Google에 보내는 approveuser 콜백을 DCB3 사양에서 벗어난 것으로 대체합니다.

DCB3에서는 인증과 연결이 단일 흐름으로 결합되었습니다. Google Standard Payments에서 인증은 계정 연결과는 별개의 문제입니다.

연결 흐름

토큰화된 FOP의 연결 흐름에 관한 일반적인 개요는 이 페이지를 참고하세요.

이동통신사 결제 도구에 사용되는 연결 흐름과 일반적인 토큰화된 FOP 흐름의 주요 차이점은 결제 통합업체가 추가 사용자 요청을 요청했는지에 따라 associateAccount 메서드에 제공되는 인증 증명이 달라진다는 것입니다.

결제 통합업체가 추가 사용자 자격 확인을 원한다고 응답한 경우, 인증 증빙 자료는 Google이 추가 자격 확인에 사용한 특정 인증 메커니즘에 의해 생성된 신원 증명입니다. 예를 들어 SMS-MT OTP 메커니즘에서 생성되는 인증 증명은 sendOtp 메서드의 requestId에 OTP 자체를 더한 것입니다.

결제 수단 속성

일반적인 토큰화된 FOP 개요의 결제 수단 속성 섹션에서는 accountAlias, accountNickname, fullAccountNickname의 개념을 설명합니다.

이동통신사 결제 관련 세부사항

• accountAlias는 사용자의 전화번호여야 합니다. 이 ID는 사용자가 계정과 관련하여 Google 지원팀에 전화를 걸 때 결제 수단을 식별하는 데 사용됩니다.
• accountNickname 및 fullAccountNickname은 UI에서 결제 수단을 식별하는 데 사용되는 표시 이름입니다.

DCB3 사양과 비교

연결 흐름은 DCB3 사양의 다음 구성요소를 대체합니다.

• GetProvisioning SOAP 호출
• Get구독자Address SOAP 호출
• 이동통신사 생성 OUT

여기서 큰 차이점은 Google이 Google 결제 토큰(GPT)을 생성하는 대신 연결 흐름 중에 생성한다는 점입니다.

또한 OUT의 범위가 특정 BillingAgreementId로 지정되는 DCB3과 달리 GPT는 특정 PaymentIntegratorAccountID로 범위가 지정되지 않습니다.

갱신 토큰 흐름

토큰화된 FOP의 토큰 갱신 흐름에 관한 일반적인 개요는 이 페이지를 참조하세요.

이동통신사 결제 관련 세부사항

이동통신사 결제 수단의 경우 정기 결제 주문이 취소되므로 Google 결제 토큰이 만료되는 것을 권장하지 않습니다. 토큰을 만료하고 갱신 토큰 흐름에 의존하여 문제를 해결하는 대신, 아래에 설명된 계정 업데이트 흐름을 대신 사용하여 사용 사례를 수행할 수 있는 경우가 많습니다.

계정 업데이트 흐름

계정 업데이트 흐름을 통해 결제 통합업체가 사용자의 통합업체 계정 업데이트에 대해 Google에 알릴 수 있습니다. 이러한 필드는 원래 연결 흐름 중에 Google에 제공됩니다. 결제 통합업체가 업데이트할 수 있는 계정 데이터의 예는 다음과 같습니다.

• 사용자의 월간, 일일, 항목당 거래 한도
• 사용자 통합업체 계정의 프로비저닝 상태
• 사용자의 통합업체 계정 유형 (선불, 후불, 기업 등)
• 사용자의 'accountAlias', 'accountNickname' 또는 'fullAccountNickname'
• 사용자가 사전 공유된 고정 PIN의 설정, 삭제 또는 변경 여부
• 사용자의 계정이 폐쇄되었는지 또는 전화번호를 변경했는지에 상관없이 Google 시스템에서 사용자의 결제 수단이 무효화됩니다.
• 토큰 삭제 흐름

DCB3 사양과 비교

계정 업데이트 흐름은 DCB3 사양의 다음 구성요소를 대체합니다.

• GetProvisioning SOAP 호출 폴링
• 주기적 토큰 무효화

구매 흐름

토큰화된 FOP의 구매 흐름에 관한 일반적인 개요는 이 페이지를 참고하세요.

이동통신사 결제 관련 세부사항

일부 이동통신사는 구매 시 USSD 또는 기타 기술을 사용하여 사용자로부터 PIN을 수집합니다. 이러한 이동통신사의 경우 capture()를 호출하는 대신 aasyncCapture()를 호출합니다. 이동통신사에서 사용자에게 PIN을 요청하는 메시지를 표시하고 캡처를 완료하는 동안 30초 동안 허용합니다. 결제의 최종 상태가 결정되면 운송업체는 captureResultNotification()을 호출하여 Google에 결과를 알립니다.

DCB3 사양과 비교

여기에는 큰 변화가 있습니다.

• 단일 동기 메서드 호출 -- auth() 대신 capture() + 일괄 처리 파일
• 배치 파일 없음
• cancel() 메서드 없음 (승인 + 취소 대신 캡처 + 환불)
• 응답에 user_message 필드가 없습니다. 거부 코드는 사용자의 계정 언어로 현지화된 Google 소유 메시지에 매핑됩니다.
• 주요 용어가 변경되었습니다.
  • CorrelationId -> requestId
  • BillingAgreementId -> paymentIntegratorAccountId
  • OperatorUserToken -> googlePaymentToken

이의가 있는 구매 흐름

각 구매 전에 사용자에게 인증 요청을 포함하는 구매 흐름을 지원하기 위해 개발이 계속 진행 중입니다. 연결 흐름 전에 사용할 수 있는 대부분의 인증 방식은 챌린지 구매 흐름 전에도 사용하여 추가 사용자 인증을 제공할 수 있습니다.

환불 절차

토큰화된 FOP의 환불 흐름에 관한 일반적인 개요는 이 페이지를 참고하세요.

토큰화된 FOP는 단일 메시지 환불 흐름을 지원합니다. 환불 메서드는 구매 금액 전액 환불 또는 구매 일부 환불을 지원합니다. 구매 1건을 부분 환불로 여러 번 환불받을 수 있습니다.

이동통신사 결제 관련 세부사항

환불 흐름에는 이동통신사 결제 수단에 관한 특별한 내용이 없습니다.

DCB3 사양과 비교

환불은 파일이 아닌 동기식 API 호출에 의해 트리거됩니다. 또한 전액 환불 1건만 지원하는 대신 원래 결제 1건에 부분 환불을 여러 건 만들 수 있습니다.

송금 흐름

토큰화된 FOP의 송금 흐름에 관한 일반적인 개요는 이 페이지를 참조하세요.

송금 흐름은 Google과 결제 통합업체가 결제를 수행하는 방법입니다. Google은 기록 회계 시스템이며 송금 송금을 처리합니다. Google은 정기적으로 결제 통합업체에 송금 명세서를 보냅니다. 이 명세서는 결제 통합업체가 Google에 지불해야 하는 금액의 요약과 Google에 지불하는 방법에 대한 지침을 제공합니다. 결제 통합업체가 조정할 수 있도록 결제 통합업체가 송금 명세서를 구성하는 거래 수준 세부정보를 Google에 쿼리할 수 있습니다.

이동통신사 결제 관련 세부사항

이동통신사 결제 remittanceStatementDetails에는 아직 송금 흐름의 API 정의에 나열되지 않은 추가 필드가 포함되어 있습니다. 예를 들면 다음과 같습니다

• revshareCategory
• itemPrice
• tax
• timestamp

Google과 50/50 수익 공유 분할 계약을 체결한 이동통신사의 경우 remittanceStatementDetails에 표시된 수수료가 이벤트별로 표시되지 않고 revshareCategory별로 집계됩니다.

DCB3 사양과 비교

송금 흐름은 DCB3 사양의 다음 개념을 대체합니다.

• 월별 청구 보고서/PaymentReport PDF
• 월별 인보이스 세부정보 CSV 파일
• 일일 정찰 CSV 파일

여기서 주요 차이점은 모든 파일을 삭제하고 일일 송금을 지원한다는 것입니다. 파일 대신 송금액이 동기 API를 통해 전달되며 다른 API는 송금 명세서의 세부정보 쿼리를 지원합니다.

사기 신고 흐름

사기 신고 흐름을 사용하면 결제 통합업체가 fraudNotification 메서드를 호출하여 허위일 가능성이 있는 거래를 Google에 알릴 수 있습니다. 이 흐름은 Google의 내부 위험 엔진을 업데이트하는 데 사용되며 자금 이동을 시작하지 않습니다.

이동통신사 결제 관련 세부사항

결제 취소 알림 흐름에는 이동통신사 결제 수단과 관련된 특별한 내용이 없습니다.