Markdownをコピー
PayPal 処理フロー（プロトコルタイプ）
取引状態遷移
都度決済
PayPalの取引状態はこちら
PayPal上での認証、支払操作完了後の決済処理後、
決済失敗かつエラー詳細コードが P01020006、P01020008 、P01020011の取引に対して操作が行われる場合があります。
PayPal側で一旦保留とされ審査が行われます。支払い審査は通常24時間程度で完了し、
その結果問題なければ決済成功（CAPTUREまたはSALES）、問題があると判断されれば決済失敗（PAYFAIL）となります。
各操作を行った際の取引状態の遷移
各操作を行った際の取引状態の遷移です。
「ー」は該当する結果、もしくは操作がないことを表しています。
| 取引登録 （API） | 決済実行 （API） | PayPal上での支払い完了 （成功） | PayPal上での認証、 支払操作画面でキャンセル | 支払い操作未完了で 支払期限切れ | 実売上 （API） | 仮売上取消 （API） | キャンセル （API） | PayPal側でのステータス変更 （非同期処理） | |
|---|---|---|---|---|---|---|---|---|---|
未決済UNPROCESSED | ー | (OK)要求成功 (NG)未決済 | ー | ー | ー | ー | ー | ー | ー |
要求成功REQSUCCESS | ー | ー | 仮売上／即時売上 | 決済失敗 | 期限切れ | ー | ー | ー | ー |
仮売上AUTH | ー | ー | ー | ー | ー | (OK)実売上 (NG)決済失敗 | (OK)仮売上取消 (NG)仮売上 | ー | ー |
実売上SALES | ー | ー | ー | ー | ー | ー | ー | (OK)キャンセル (NG)実売上 | ー |
即時売上CAPTURE | ー | ー | ー | ー | ー | ー | ー | (OK)キャンセル (NG)即時売上 | ー |
キャンセルCANCEL | ー | ー | ー | ー | ー | ー | ー | ー | ー |
仮売上取消AUTH_CANCEL | ー | ー | ー | ー | ー | ー | ー | ー | ー |
決済失敗PAYFAIL | ー | ー | ー | ー | ー | ー | ー | ー | 即時売上／ 実売上／ 決済失敗 |
期限切れEXPIRED | ー | ー | ー | ー | ー | ー | ー | ー | ー |
利用承諾
各操作を行った際の取引状態の遷移
各操作を行った際の取引状態の遷移です。
「ー」は該当する結果、もしくは操作がないことを表しています。
| 取引登録 （API） | 決済実行 （API） | PayPal上での認証、 利用承諾処理完了後の 決済処理 | お客様がPayPal上で キャンセル | 利用承諾終了 （API） | 利用承諾 操作を 行わず 期限切れ | |
|---|---|---|---|---|---|---|
未決済UNPROCESSED | ー | (OK)要求成功 (NG)未決済 | ー | ー | ー | ー |
要求成功REQSUCCESS | ー | ー | (OK)利用承諾 (NG)決済失敗 | 決済失敗 | ー | 期限切れ |
利用承諾REGISTER | ー | ー | ー | ー | (OK)利用承諾終了 (NG)利用承諾 | ー |
利用承諾終了END | ー | ー | ー | ー | ー | ー |
決済失敗PAYFAIL | ー | ー | ー | ー | ー | ー |
期限切れEXPIRED | ー | ー | ー | ー | ー | ー |
随時決済
保留中（PENDING）ステータスについて
このステータスは即時売上運用の場合のみ発生する可能性があります。
決済処理後、保留中かつエラー詳細コードがP01020006、P01020008 、P01020011 の取引に対して操作が行われる場合があります。PayPal側で一旦保留とされ審査が行われます。支払い審査は通常24時間程度で完了し、その結果問題なければ即時売上（CAPTURE）、問題があると判断されれば決済失敗（PAYFAIL）となります。
各操作を行った際の取引状態の遷移
各操作を行った際の取引状態の遷移です。
「ー」は該当する結果、もしくは操作がないことを表しています。
| 取引登録 （API） | 決済実行 （API） | PayPal側での ステータス変更 （非同期処理） | 実売上 （API） | 仮売上取消 （API） | キャンセル （API） | |
|---|---|---|---|---|---|---|
未決済UNPROCESSED | ー | (OK)保留中／仮売上／即時売上 (NG)未決済／決済失敗 | ー | ー | ー | ー |
保留中PENDING | ー | ー | (OK)即時売上 (NG)決済失敗 | ー | ー | ー |
仮売上AUTH | ー | ー | ー | (OK)実売上 (NG)仮売上／決済失敗 | (OK)仮売上取消 (NG)仮売上 | ー |
実売上SALES | ー | ー | ー | ー | ー | (OK)キャンセル (NG)決済失敗 |
即時売上CAPTURE | ー | ー | ー | ー | ー | (OK)キャンセル (NG)即時売上 |
キャンセルCANCEL | ー | ー | ー | ー | ー | ー |
仮売上取消AUTH_CANCEL | ー | ー | ー | ー | ー | ー |
決済失敗PAYFAIL | ー | ー | ー | ー | ー | ー |
期限切れEXPIRED | ー | ー | ー | ー | ー | ー |
決済処理シーケンス
随時決済の「利用承諾」「都度決済+利用承諾」は都度決済の各APIを利用して行います。 そのため、「利用承諾」「都度決済+利用承諾」の流れは都度決済と同様です。
都度決済
- お客様がお支払い手段にPayPal決済を選択します。
- 加盟店様は当サービスの取引登録（
EntryTranPaypal）APIを行います。 - 加盟店様は当サービスの決済実行（
ExecTranPaypal）APIを行います。 - 当サービスは、PayPalとの通信を行い決済要求結果を返します。
- 加盟店様は、リダイレクト機能を使用し、
お客様を当サービスの支払手続き開始IF（PaypalStart）APIに誘導します。 - 当サービスは、リダイレクト機能を使用し、お客様をPayPal承認画面に誘導します。
- お客様は、PayPalの承認画面にログインします。
- お客様は、PayPalの承認画面にて決済を承認します。
- お客様は、当サービスにて表示した決済確認画面から、決済を実行します。
- 当サービスは、PayPalとの通信を行い決済処理を行います。
- 当サービスは、リダイレクト経由で決済結果を返します。
- 加盟店様は、決済結果をお客様に表示します。
随時決済
- 加盟店様は当サービスの取引登録（
EntryTranPaypal）APIを行います。 - 加盟店様は「利用承諾」「都度決済+利用承諾」に発行された支払同意IDを指定し、決済実行（
ExecTranPaypal）APIを行います。 - 当サービスがPayPalに対して決済処理を行い、加盟店様に決済結果を返却します。