リカーリングペイメントは、
定期的な決済に際して、
- paypal.
com内 定期支払い紹介ページ - http://
bit. ly/ e0o33V
定期支払いの決済フロー
定期支払いに同意
購入者は購入する商品またはサービスを選択後、
PayPalにログインし、 定期支払いの詳細 (支払い期間、 周期、 代金など) を確認後、 同意します。 定期支払いに同意したことを通知
ECサイトの事業主に、
購入者が定期支払い同意したことを知らせるメールがPayPalから届きます。 定期的な支払い
定期的に決済が行われ、
決済が完了するたびに、 購入者およびECサイトの事業主に、 決済完了を知らせるメールがPayPalから届きます。 商品、
サービスの提供 ECサイトの事業主が、
定期的な支払いを確認後、 商品およびサービスを購入者に提供します。
なお、
リカーリングペイメントの実装に必要なもの
- PayPalのビジネスアカウント
- API証明書
- sandbox内のテスト用アカウント
(詳細は前回の「PayPalのエクスプレス チェックアウトの実装」 の 「エクスプレス チェックアウトの実装に必要なもの」 セクションを参考にしてください)
リカーリングペイメントの実装
リカーリングペイメントの実装は以下のステップで実装します。
SetExpressCheckout APIをコールします。定期支払いであることを指定するため以下のパラメータも追加します。
またここで定期支払いには含まれない初回分の精算などの決済を行う場合は、
その額を&AMTパラメータに指定してください。 SetExpressCheckoutのレスポンスにあるtokenを付加してpaypal.
comにリダイレクトします。ログイン後にPayPalのログイン画面を日本語で表示させる場合はリダイレクトのURLに&locale. x=ja_ JPを追加します。 購入者がPayPalにログイン後、
定期支払いに同意するための確認画面が表示されます。ここでは定期支払いに同意する旨の同意文は表示されますが、 定期支払いの詳細 (頻度、 額など) に関しては表示されません。購入者が同意した後、 SetExpressCheckoutで指定した戻り先のURLにtokenと決済をした購入者の特定できるpayeridが付加されてリダイレクトされます。 tokenとpayeridを含んだパラメータを渡してGetExpressCheckoutDetails APIをコールし、
SetExpressCheckoutで指定した内容を取得できます。購入者はここでECサイト内の画面で定期支払いの契約内容の確認を行うこともできます。ただし、 定期支払いに関する詳細設定は次のCreateRecurringPaymentsProfileで行うため、 GetExpressCheckoutDetailsではレスポンスがなく、 DBなどに保存している値を使って購入者に対して確認することが必要です (このステップは省略可能です)。 tokenとpayeridと定期支払いに関する詳細
(頻度、 額など) をパラメータで渡し、 CreateRecurringPaymentsProfile APIをコールして、 定期支払いの契約の締結を終了します。 - ※注意:このAPIに渡す&DESCパラメータには1.の&L_
BILLINGAGREEMENTDESCRIPTION0で指定した値と同じものを指定するようにしてください。
- ※注意:このAPIに渡す&DESCパラメータには1.の&L_
IPNでの決済の確認
一度定期支払いが締結されると、
IPNリスナー用の設定は、
- PayPalのアカウントにログイン
- 「個人設定」
をクリック - 「即時支払い通知の設定」
をクリック - 表示されるページからURLを設定
リカーリングペイメントの場合は主に以下のtxn_
- recurring_
payment_ created: 定期支払いの契約締結に成功 - recurring_
payment: 定期支払いの決済に成功 - recurring_
payment_ failed: 定期支払いの決済に失敗
txn_
- txn_
typeの詳細紹介ページ (英語) - http://
bit. ly/ yz4vF6 - IPNの紹介PDF
(英語) - http://
bit. ly/ kwRjOS
定期支払いは一度、
リカーリングペイメントの実装のためのリソース
- PayPal Express Checkout Integration Guide
(PDF) - http://
bit. ly/ hpFl9H (英語:最新版 33ページ以降) - http://
bit. ly/ ijuKj3 (日本語:2009年10月版 78ページ以降) - Name-Value Pair API Developer Guide
(PDF) - http://
bit. ly/ hWU8MF (英語:最新版 119ページ以降) - http://
bit. ly/ iKZxZR (日本語:2008年11月版 65ページ以降)