概要
Card FOP(Form of Payment)API は、標準のカードを使用した支払いをサポートしています。クレジット カードまたはデビットカードを使用できます。支払いには、シングル メッセージ フローとデュアル メッセージ フローが用意されています。
重要なコンセプト
記号と規則
これらのドキュメント内のキーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD NOT」、「RECOMMENDED」、「MAY」、「OPTIONAL」は、RFC 2119 で説明されているように解釈されます。
タイムスタンプ
タイムスタンプはすべて、Unix エポックからのミリ秒数(UTC)で表されます。
例:
- 2010 年 8 月 14 日 16:30:00.00 AM(GMT = 1281803400000)
- 2007 年 11 月 6 日午後 9:37:00(MST)= 1194410220000
金額
この API の金銭的価値は、Google の標準である「マイクロ」という形式を使用して表されます。マイクロは整数ベースの固定精度の形式です。金銭的価値をマイクロ単位で表すには、標準通貨の価値に 1,000,000 を掛けます。
例:
- USD$1.23 = 1230000 マイクロ 米ドル
- USD$0.01 = 10000 マイクロ 米ドル
べき等性
この API 内のすべてのメソッド呼び出しは、べき等の動作である必要があります。簡単に言うと、インテグレータは、すでに正常に処理されたリクエストを再処理しようとしないでください。代わりに、処理が成功したことに対するレスポンスが報告されます。すべてのメソッドには、requestId を含む共通の RequestHeader があります。この requestId はすべての呼び出しのべき等性のキーです。
終端以外の応答(HTTP 200 以外の応答)については、べき等に処理しないでください。そのため、以前に 400 を受け取ったリクエストを 2 回目に呼び出されたときに、400 をべき等に返すことはできません。再度評価する必要があります。再評価時には 400 が返されるか、正常に処理される可能性があります。
べき等性の詳細については、こちらの詳細なガイドをご覧ください。
予約のキャプチャ フロー
予約キャプチャ フローは、最初に資金が予約され、その後キャプチャされる 2 つのメッセージ フローです。予約の処理中、金銭の移動は行われません。その後、予約をキャンセルまたはキャプチャできます。キャプチャまたはキャンセルの最終結果は、通知を通じて Google に非同期で返されます。
決済インテグレータは、
Google が実装する
captureFundsReservationResultNotification
cancelFundsReservationResultNotification
setAcquirerReferenceNumberForCaptureNotification
予約キャプチャの詳細については、こちらの詳細なガイドをご覧ください。
振込フロー
資金移動フローは、資金を直接回収する単一のメッセージ フローです。このフローは、Capture
という名前の決済インテグレータによって実装される単一のメソッドで構成されています。このメソッドは、利用可能な残高を同期的にチェックし、成功した場合は資金をキャプチャします。
決済インテグレータは、
Google が実装する
振込について詳しくは、こちらの詳細なガイドをご覧ください。
払い戻しフロー
払い戻しフローは、以前に予約回収フローまたは送金フローで回収された資金を返送するために使用されます。
決済インテグレータは、
Google が実装する
払い戻しについて詳しくは、こちらの詳細なガイドをご覧ください。
異議申し立てフロー
異議申し立てフローは、お客様が払い戻しを要求している異議申し立てとチャージバックを Google に通知するために使用されます。すべての呼び出しが金銭の移動を含むとは限りませんが、このフローを使用して顧客に返金したり、逆にして Google に返金したりできます。このフローは、不正行為の報告フローに加えて使用できますが、必ずしも不正行為に関するフローではありません。
Google が実装する
異議申し立てについて詳しくは、こちらの詳細なガイドをご覧ください。
不正行為の報告フロー
不正行為の報告フローは、不正行為の可能性を Google に通知するためのものです。この情報は金銭の移動を示唆するものではなく、全体的な不正行為を防止するために Google のリスクエンジンにイベントを通知するためにのみ使用されます。この場合、異議申し立てフローを使用した、異議申し立てまたはチャージバックが付随する可能性があります。
Google が実装する
不正行為の報告の詳細については、こちらの詳細なガイドをご覧ください。