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이 반환되거나 성공적으로 처리될 수 있습니다.

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

캡처 예약 흐름

예약 캡처 흐름은 자금이 먼저 예약된 후에 나중에 캡처됩니다. 예약 중 자금 이동이 발생하지 않습니다 그러면 예약을 취소하거나 캡처할 수 있습니다. 이 캡처 또는 취소의 최종 결과가 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

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