Google 표준 결제: 카드 FOP

개요

Card FOP (Form of Payment) API는 표준 카드를 사용하여 이루어지는 결제를 지원합니다. 신용카드와 체크카드를 사용할 수 있습니다. 결제를 위해 단일 메시지 흐름과 이중 메시지 흐름이 모두 제공됩니다.

주요 개념

기호 및 규정

이러한 문서의 핵심 단어 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'MAY' 및 'OPTIONAL'은 RFC 2119에 설명된 대로 해석되어야 합니다.

타임스탬프

모든 타임스탬프는 Unix 에포크 이후 UTC 기준으로 밀리초로 표시됩니다.

예를 들면 다음과 같습니다.

• 2010년 8월 14일 16:30:00.00 GMT = 1281803400000
• 2007년 11월 6일 오후 9:37:00 MST = 1194410220000

금액

이 API의 금액은 Google의 표준인 'micros'라는 형식으로 표시됩니다. 마이크로는 정수 기반의 고정 정밀도 형식입니다. 금전적 가치를 마이크로 단위로 나타내려면 표준 통화 값에 1,000,000을 곱합니다.

예를 들면 다음과 같습니다.

• 1.23달러 = 1230,000마이크로달러
• 미화 0.01달러 = 10,000마이크로 미화

멱등성

이 API 내의 모든 메서드 호출에는 멱등성이 있는 동작이 있어야 합니다. 간단히 말해 통합자는 이미 성공적으로 처리된 요청을 다시 처리하려고 시도해서는 안 됩니다. 대신 성공적인 처리에 대한 응답을 보고해야 합니다. 모든 메서드에는 requestId를 포함하는 공통 RequestHeader가 있습니다. 이 requestId는 모든 호출에 대한 멱등성 키입니다.

비 터미널 응답 (HTTP 200이 아닌 응답)의 경우 멱등적으로 처리하면 안 됩니다. 따라서 이전에 400을 반환한 요청은 두 번째로 호출될 때 멱등적으로 400을 반환해서는 안 되며 반드시 재평가해야 합니다. 재평가 시 400이 반환되거나 성공적으로 처리될 수 있습니다.

멱등성에 관한 자세한 내용은 이 상세 가이드를 참고하세요.

캡처 예약 흐름

예약 캡처 흐름은 금액이 먼저 예약되고 나중에 캡처되는 2가지 메시지 흐름입니다. 예약 중에는 금액 이동이 발생하지 않습니다. 그런 다음 예약을 취소하거나 캡처할 수 있습니다. 캡처 또는 취소의 최종 결과는 알림을 통해 Google에 비동기식으로 반환됩니다.

결제 통합업체가

• reserveFunds
• asynchronousCaptureFundsReservation
• asynchronousCancelFundsReservation

Google 구현

• captureFundsReservationResultNotification
• cancelFundsReservationResultNotification
• setAcquirerReferenceNumberForCaptureNotification

예약 캡처에 관한 자세한 내용은 이 상세 가이드를 참고하세요.

송금 흐름

송금 흐름은 금액이 직접 캡처되는 단일 메시지 흐름입니다. 이 흐름은 결제 통합업체가 구현한 Capture라는 단일 메서드로 구성됩니다. 이 메서드는 사용 가능한 자금을 동기식으로 확인하고 성공하면 자금을 캡처합니다.

결제 통합업체가

• capture

Google 구현

• setAcquirerReferenceNumberForCaptureNotification

송금에 대한 자세한 내용은 이 상세 가이드를 참조하세요.

환불 절차

환불 흐름은 예약 캡처 흐름 또는 송금 흐름을 통해 이전에 수취한 금액을 반환하는 데 사용됩니다.

결제 통합업체가

• asynchronousRefund

Google 구현

• refundResultNotification
• reverseRefundNotification
• setAcquirerReferenceNumberForRefundNotification

환불에 관한 자세한 내용은 이 상세 가이드를 참고하세요.

이의 제기 절차

이의 제기 흐름은 고객이 환불을 요청하는 이의 제기 및 지불 거절을 Google에 알리는 데 사용됩니다. 모든 호출이 금액 이동을 의미하는 것은 아니지만, 이 흐름을 사용하여 고객에게 금액을 돌려주거나 이를 취소했다가 Google로 돌려받을 수 있습니다. 이 흐름은 사기 신고 흐름과 함께 사용할 수 있지만 반드시 사기가 포함된 것은 아닙니다.

Google 구현

• inquiryNotification
• chargebackNotification
• chargebackReversedNotification

이의 제기에 대한 자세한 내용은 이 상세 가이드를 참조하세요.

사기 신고 흐름

사기 신고 흐름은 Google에 잠재적 사기를 알리기 위한 것입니다. 이 정보는 돈 이동을 의미하지 않으며, 전반적인 사기를 줄이기 위해 Google 위험 엔진에 사건을 알리는 데만 사용됩니다. 이러한 상황에는 이의 제기 흐름을 통해 이의 제기나 지불 거절이 수반될 수 있습니다.

Google 구현

• fraudNotification

사기 신고에 관한 자세한 내용은 이 상세 가이드를 참고하세요.