概要
Card FOP(Form of Payment)API は、 表示されます。クレジット カードとデビットカードをご利用いただけます。1 つの Deployment と 二重メッセージ フローが提供されます。
重要なコンセプト
記号と規則
これらのドキュメント内のキーワード「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 が返されるか、正常に処理される可能性があります。
べき等性の詳細については、こちらの詳細なガイドをご覧ください。
予約の回収フロー
予約キャプチャ フローは、 最初に予約されてから獲得される資金です。予約中 金銭の移動は行われません。その後、予約をキャンセルまたはキャプチャできます。「 回収またはキャンセルの最終結果が Google に非同期で返される 通知で通知されます。
決済インテグレータは
Google は
captureFundsReservationResultNotification
cancelFundsReservationResultNotification
setAcquirerReferenceNumberForCaptureNotification
予約取得の詳細については 詳細ガイドをご覧ください。
振込フロー
資金移動フローは、
どのファンドが直接獲得されるかを
検討しますこのフローは単一のメソッドで構成され、
Capture
という名前の決済インテグレータによって実装されます。この方法は
は利用可能な資金を同期的にチェックし、成功した場合は資金をキャプチャします。
決済インテグレータは
Google は
振込について詳しくは、こちらの 詳細ガイドをご覧ください。
払い戻しフロー
払い戻しフローを使用して、払い戻しを受ける 予約キャプチャ フローまたは 振込フロー。
決済インテグレータは
Google は
払い戻しについて詳しくは、こちらの詳細ガイドをご覧ください。
異議申し立てフロー
異議申し立てフロー。は、Google に異議を申し立て、 お客様が返金を求めている場合のチャージバック。すべての呼び出しではなく 金銭の移動を意味しますが このフローを使用して Google に返却することもできますこのフローは 不正行為の報告フローに追加されますが、 不正行為が含まれます
Google は
異議申し立てについて詳しくは、こちらの詳細ガイドをご覧ください。
不正行為報告フロー
不正行為の報告フローは、 特定します。この情報は金銭の移動を示唆するものではなく、 イベントについて Google のリスクエンジンに通知し、 減らすことができますこれには、異議申し立てまたはチャージバック(代金請求の差し戻し)が 異議申し立てフローを行います。
Google は
不正行為の報告について詳しくは、こちらの 詳細ガイドをご覧ください。