🙉 ⬜️ 🍋 Paypal経由の支払いをウェブアプリケーションに統合します 👃 🍐 ♥️

この記事では、1回限りの支払いと、WebアプリケーションでPaypalを使用したサブスクリプション支払いの統合について説明します。これらの例はPHPで実装されていますが、原則として、他のテクノロジーを使用しても問題なく同じことができます。この方法は、単純さと柔軟性の間の妥協案として選択されます。これは、トピックをすばやく理解し、Paypalを介して支払いをプロジェクトに統合するのに役立つガイドを作成する試みです。

この記事は、主にこのシステムを使用したことがない人に焦点を当てています。 Paypalの専門家がここで自分自身で新しいものを見つけることはまずありません。しかし、おそらく、彼らはこの方法の短所を指摘したり、どのように異なる方法で実装できるのかをアドバイスするでしょう。

アカウント作成

このスキームを実装するには、ビジネスアカウントが必要です。 PayPal Payments Standardで十分です。

リンクに従ってアカウントを作成します。

サンドボックスアカウントの作成

Paypal Sandboxを使用して、アプリケーションをテストします。 2つのサンドボックスアカウントが必要です。バイヤーアカウント（バイヤー）とセラーアカウント（ファシリテーター）。まず、両方のサンドボックスアカウントにパスワードを設定する必要があります。これを行うには、開発者セクションの paypalウェブサイトにアクセスしてください。ログインして、ダッシュボードに移動します。左側のメニューには、[サンドボックス]セクションの[アカウント]タブがあります。ここでは、2つのサンドボックスアカウント（BuyerとFacilitator）を見ることができます。

プロファイルをクリックし、表示されたモーダルウィンドウで[パスワードの変更]をクリックし、パスワードを保存します。

両方のアカウントにパスワードを設定します。その後、 Paypal Sandbox Webサイトにアクセスして、ログインしてみてください。

Paypalのセットアップ

次に、資金を受け取るPaypal Facilitatorアカウントを設定する必要があります。 Sandbox Webサイトにアクセスし、ファシリテーターアカウントを使用してログインし、プロファイル設定にアクセスします。プロファイルメニューを開き、販売ツールのアイテムを選択します。

[オンライン販売]セクションで、[ウェブサイトの設定]を選択し、[更新]をクリックします。ここで、ユーザーのリダイレクトを有効にできます。支払いが完了すると、ユーザーはデフォルトで指定されたURLにリダイレクトされます。ただし、ユーザーを別のURLにリダイレクトすることもできます（以下を参照）。

また、Paypalインスタント支払い通知をアクティブにする必要があります。これを行うには、「支払いの取得とリスクの管理」セクションで、「即時支払い通知」項目を選択し、「更新」をクリックします。

IPN設定で、IPNリスナーが機能するURLを指定します。このURLはグローバルにアクセス可能である必要があります操作の通知を受け取ります。

メッセージ配信をオンにして保存します。これでアカウントのセットアップが完了しました。支払いの設定を直接開始できます。

一回払い

まず、1回限りの支払いを行います。これはおそらく最も一般的な使用例です。ユーザーは、製品または1回限りのサービスを購入したいだけです。まあ、私はペイパルの設定で何も変更する必要がもうないことを望みます。商品と価格のリストはアプリケーションのデータベースに保存されますが、必要に応じて変更できます。 1回限りの支払いには、支払いボタン（PayPal Payments Standard）を使用します。

データ構造

商品のリストは、アプリケーションのデータベースに保存されます。製品はいつでも追加および削除および編集できます。ここでは最も単純な構造が示されており、すべての情報が1つのテーブルに保存されています。

ただし、タスクを複雑にすることができます。たとえば、注文した商品の数量に応じて価格を変更したり、曜日と時間に応じて価格を変更したりします。

または、注文に多くの異なる製品を含めます。

製品-ここで商品を保管します：

id	お名前	価格	説明
1	製品1	1.0	...
2	製品2	4.0	...

ユーザー-ここにユーザーを保存します：

id	名	姓	メール	パスワード
315	アラン	スミス	alansmith@example.com	$ 1 $ 2z4.hu5。$ E3A3H6csEPDBoH8VYK3AB0
316	ジョー	ドウ	joedoe@example.com	$ 1 $ Kd4.Lf0。$ PGc1h7vwmy9N6EJxac953 /

products_users-発送先：

id	user_id	product_id	items_count	created_date
1	315	1	3	2015-09-03 08:23:05

また、トランザクション履歴をデータベースのトランザクションテーブルに保存します。

txn_id

txn_type

mc_gross

mc_currency

量

支払日

payment_status

事業

receiver_email

payer_id

payer_email

relation_id

relation_type

created_date

お支払い方法

まず、注文フォームを作成します。アプリケーションでフォームを生成し、注文の主なパラメーター（製品名、価格、数量）を指定します。

ここで、価格、名前、数量などを指定できます。カスタムフィールドは、任意のデータを転送できるという点で便利です。ここでは、製品ID、ユーザーID、およびその他の情報を渡します。今後の支払い処理のためにこれらのデータが必要になります。

複数のパラメーターを渡す必要がある場合は、jsonまたはシリアル化を使用できます。または、on0、on1、os0、os1の形式の追加フィールドを使用できます。個人的に、私はこれをチェックしませんでした、私はここで情報を見つけました。

以下はフォームの例です：

<?php $payNowButtonUrl = 'https://www.sandbox.paypal.com/cgi-bin/websc'; $userId = 315 // id   $receiverEmail = 'xxx-facilitator@yandex.ru'; //email  (   paypal ) $productId = 1; $itemName = 'Product 1'; //   $amount = '1.0'; //  ( 1 .) $quantity = 3; //  $returnUrl = 'http://your-site.com/single_payment?status=paymentSuccess'; $customData = ['user_id' => $userId, 'product_id' => $productId]; ?> <form action="<?php echo $payNowButtonUrl; ?>" method="post"> <input type="hidden" name="cmd" value="_xclick"> <input type="hidden" name="business" value="<?php echo $receiverEmail; ?>"> <input id="paypalItemName" type="hidden" name="item_name" value="<?php echo $itemName; ?>"> <input id="paypalQuantity" type="hidden" name="quantity" value="<?php echo $quantity; ?>"> <input id="paypalAmmount" type="hidden" name="amount" value="<?php echo $amount; ?>"> <input type="hidden" name="no_shipping" value="1"> <input type="hidden" name="return" value="<?php echo $returnUrl; ?>"> <input type="hidden" name="custom" value="<?php echo json_encode($customData);?>"> <input type="hidden" name="currency_code" value="USD"> <input type="hidden" name="lc" value="US"> <input type="hidden" name="bn" value="PP-BuyNowBF"> <button type="submit"> Pay Now </button> </form>

実際、パラメーターはもっと大きくすることができ、詳細な情報はドキュメントにあります。フォームを送信すると、ユーザーはペイパル支払いページに移動し、注文の詳細が再び表示されます。

ここで、ユーザーは、PayPalアカウントまたは銀行カードを使用して注文の代金を支払うことができます。その後、ユーザーは当社のWebサイト（リダイレクトパラメーター）にリダイレクトされ、そこで支払いが処理されていることを通知できます。

即時支払い通知（IPN）

ユーザーが支払いを行った後、Paypalはそれを処理し、アプリケーションに確認を送信します。これを行うには、即時支払い通知（IPN）サービスを使用します。

記事の冒頭で、Paypalアカウントを設定し、IPN通知URLを設定します。ここで、IPN要求を処理するIPNリスナーを作成します。 PaypalはIPNリスナーの実装例を提供します。サービスの詳細な説明はここで見つけることができます。要するに、Paypalはユーザーの支払いを処理し、すべてが正常であり、支払いが正常に完了したことを確認します。その後、IPNはPostというフォームの通知URLにリクエストを送信します。

 mc_gross=37.50&protection_eligibility=Ineligible&payer_id=J86MHHMUDEHZU&tax=0.00&payment_date=07%3A04%3A48+Mar+30%2C+2015+PDT&payment_status=Completed&charset=windows-1252&first_name=test&mc_fee=1.39¬ify_version=3.8&custom=%7B%22user_id%22%3A314%2C%22service_provider%22%3A%22twilio%22%2C%22service_name%22%3A%22textMessages%22%7D&payer_status=verified&business=antonshel-facilitator%40gmail.com&quantity=150&verify_sign=AR-ITpb83c-ktcbmApqG4jM17OeQAx2RSvfYZo4XU8YFZrTSeF.iYsSx&payer_email=antonshel-buyer%40gmail.com&txn_id=30R69966SH780054J&payment_type=instant&last_name=buyer&receiver_email=antonshel-facilitator%40gmail.com&payment_fee=1.39&receiver_id=VM2QHCE6FBR3N&txn_type=web_accept&item_name=GetScorecard+Text+Messages&mc_currency=USD&item_number=&residence_country=US&test_ipn=1&handling_amount=0.00&transaction_subject=%7B%22user_id%22%3A314%2C%22service_provider%22%3A%22twilio%22%2C%22service_name%22%3A%22textMessages%22%7D&payment_gross=37.50&shipping=0.00&ipn_track_id=6b01a2c76197

IPNリスナーはこのリクエストを処理する必要があります。特に：

リクエストの種類（1回限りの支払いまたは定期購入）を確認します。これに応じて、処理方法が異なります。この場合、1回限りの支払い-web_acceptになります。
環境を選択します-サンドボックスまたはライブ。
要求の有効性を確認してください。 IPNリクエストがどのように見えるか、IPN通知URLを知っていれば、誰でも偽のリクエストを送信できます。したがって、このチェックを行う必要があります。

 <?php /** * Class PaypalIpn */ class PaypalIpn{ private $debug = true; private $service; /** * @throws Exception */ public function createIpnListener(){ $postData = file_get_contents('php://input'); $transactionType = $this->getPaymentType($postData); $config = Config::get(); //        if($transactionType == PaypalTransactionType::TRANSACTION_TYPE_SINGLE_PAY){ $this->service = new PaypalSinglePayment(); } elseif($transactionType == PaypalTransactionType::TRANSACTION_TYPE_SUBSCRIPTION){ $this->service = new PaypalSubscription($config); } else{ throw new Exception('Wrong payment type'); } $raw_post_data = file_get_contents('php://input'); $raw_post_array = explode('&', $raw_post_data); $myPost = array(); foreach ($raw_post_array as $keyval) { $keyval = explode ('=', $keyval); if (count($keyval) == 2) $myPost[$keyval[0]] = urldecode($keyval[1]); } $customData = $customData = json_decode($myPost['custom'],true); $userId = $customData['user_id']; // read the post from PayPal system and add 'cmd' $req = 'cmd=_notify-validate'; if(function_exists('get_magic_quotes_gpc')) { $get_magic_quotes_exists = true; } else{ $get_magic_quotes_exists = false; } foreach ($myPost as $key => $value) { if($get_magic_quotes_exists == true && get_magic_quotes_gpc() == 1) { $value = urlencode(stripslashes($value)); } else { $value = urlencode($value); } $req .= "&$key=$value"; } $myPost['customData'] = $customData; $paypal_url = 'https://www.sandbox.paypal.com/cgi-bin/websc'; //$paypal_url = 'https://www.paypal.com/cgi-bin/websc'; //   IPN  $res = $this->sendRequest($paypal_url,$req); // Inspect IPN validation result and act accordingly // Split response headers and payload, a better way for strcmp $tokens = explode("\r\n\r\n", trim($res)); $res = trim(end($tokens)); /**/ if (strcmp ($res, "VERIFIED") == 0) { //    $this->service->processPayment($myPost); } else if (strcmp ($res, "INVALID") == 0) { //     self::log([ 'message' => "Invalid IPN: $req" . PHP_EOL, 'level' => self::LOG_LEVEL_ERROR ], $myPost); } /**/ } private function sendRequest($paypal_url,$req){ $debug = $this->debug; $ch = curl_init($paypal_url); if ($ch == FALSE) { return FALSE; } curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); curl_setopt($ch, CURLOPT_POSTFIELDS, $req); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 1); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); curl_setopt($ch, CURLOPT_FORBID_REUSE, 1); if($debug == true) { curl_setopt($ch, CURLOPT_HEADER, 1); curl_setopt($ch, CURLINFO_HEADER_OUT, 1); } curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30); // ,  User-Agent -   .     live  curl_setopt($ch, CURLOPT_HTTPHEADER, array('Connection: Close', 'User-Agent: ' . $this->projectName)); $res = curl_exec($ch); curl_close($ch); return $res; } public function getPaymentType($rawPostData){ $post = $this->getPostFromRawData($rawPostData); if(isset($post['subscr_id'])){ return "subscr_payment"; } else{ return "web_accept"; } } /** * @param $raw_post_data * @return array */ public function getPostFromRawData($raw_post_data){ $raw_post_array = explode('&', $raw_post_data); $myPost = array(); foreach ($raw_post_array as $keyval) { $keyval = explode ('=', $keyval); if(count($keyval) == 2) $myPost[$keyval[0]] = urldecode($keyval[1]); } return $myPost; } } ?>

その後、Paypalがリクエストの真正性を確認した場合、さらに処理を進めることができます。

支払い処理

まず、カスタムフィールドの値を取得する必要があります。カスタムフィールドには、注文ID、ユーザーID、またはその他のもの（アプリケーションのロジックによって異なります）を渡します。したがって、データベースからユーザー/注文情報を取得できます。トランザクションIDも取得する必要があります。

Paypalは、同じ取引の確認を数回送信できます。したがって、確認する必要があり、トランザクションが処理されなかった場合は処理します。トランザクションが既に処理されている場合、何もしません。

支払いを検証します。すべてが正常であれば、支払い情報をデータベースに保存し、さらにアクションを実行できます（ユーザーに「プレミアム」ステータスを割り当て、注文ステータスを「支払い済み」など）。支払いが検証されていない場合は、理由を確認してユーザーに連絡する必要があります。さらなる操作、特に支払いのキャンセルは、手動で実行されます。

 <?php function processPayment($myPost){ $customData = json_decode($myPost['custom'],true); $userId = $customData['user_id']; $productId = $customData['product_id']; // $userService = new UserService(); $userInfo = $userService->getUserData($userId); //       $transactionService = new TransactionService(); $transaction = $transactionService->getTransactionById($myPost['txn_id']); if($transaction === null){ //      $productService = new ProductService(); $product = $productService->getProductById($productId); //    if($this->validateTransaction($myPost,$product)){ //   .     . $transactionService->createTransaction($myPost); //  -   } else{ //    .    } } else{ //,     .    } } ?>

支払い検証

支払いの検証は、アプリケーションのビジネスロジックに大きく依存しています。特定の条件が追加される場合があります。たとえば、ユーザーは15ユニットの商品を支払いましたが、利用できるのは10個だけです。そのような注文を見逃すことはできません。

ただし、フォーム生成の段階でそのようなことを確認することは理にかなっています。不正行為を防ぐためではなく、支払いの検証が必要です（たとえば、ユーザーが支払いの形で商品の量を手動で増やしたが、価格は変更しなかった場合）。

とにかくチェックアウトする価値のあるものがいくつかあります。

支払いとデータベースで価格の対応を確認します
合計コストが0に等しくないことを確認します（前の段落でこのケースを扱っているため、妄想）
正しい受取人が指定されていることを確認してください
支払い状況を確認する
支払い通貨を確認する

 <?php function validateTransaction($myPost,$product){ $valid = true; /* *    */ if($product->getTotalPrice($myPost['quantity']) != $myPost['payment_gross']){ $valid = false; } /* *     */ elseif($myPost['payment_gross'] == 0){ $valid = false; } /* *    */ elseif($myPost['payment_status'] !== 'Completed'){ $valid = false; } /* *    */ elseif($myPost['receiver_email'] != 'YOUR PAYPAL ACCOUNT'){ $valid = false; } /* *   */ elseif($myPost['mc_currency'] != 'USD'){ $valid = false; } return $valid; } ?>

さて、もちろん、チェックを追加します。

その結果、1回限りの支払いが有効になります。支払いフォームを作成する段階で、パラメーターを指定できます。たとえば、製品の価格を柔軟に制御できます（101の顧客ごとに3の価格で2、30％の割引など）。 Paypalで何かを変更する必要はありません。

サブスクリプション

次に、サブスクリプションの実装を検討します。原則は、1回限りの支払いと同じです。定期的な支払いのみ。したがって、それらの実装はやや複雑です。

いくつかの料金プランが利用できます。たとえば、無料-無料、プロ-ユーザーあたり月額5ドル、プレミアム-ユーザーあたり月額10ドルです。

ユーザーは、未使用期間の払い戻しで退会できます。また、ユーザーは、別の料金プランへの切り替え、ユーザー数の変更など、サブスクリプション条件を変更できます。

無料購読の場合、PayPalはまったく必要ないことは明らかです。おそらく、この料金プランは、アプリケーションにユーザーが登録されるとすぐに自動的にアクティブ化されるはずです。このスキームは、一部のSaaSシステムの一般的な使用方法を示しているという点で優れています。外出先では、Paypalを使用してこれを実装する方法はあまり明確ではありません。

サブスクリプションを使用するには、追加のテーブルが必要です。

subscription_plans-料金プランの保存用：

id	service_provider	service_name	価格	価格タイプ	期間
1	サービス	プロ	5.00	ユーザー	月
2	サービス	エンタープライズ	10.00	ユーザー	月
3	サービス	無料	0.00	ユーザー	月

サブスクリプション-サブスクリプションを保存するには：

user_id

plan_id

subscription_id

created_date

更新日

支払日

items_count

状態

サブスクリプションフォーム

サブスクリプションフォームは、1回限りの支払いフォームに非常によく似ています。

 <?php $payNowButtonUrl = 'https://www.sandbox.paypal.com/cgi-bin/websc'; $userId = 1 // id   $receiverEmail = 'xxx-facilitator@gmail.com'; //email  (   paypal ) $serviceId = 1; $serviceName = 'Service Pro'; //  ( ) $servicePrice = '5.00'; //   - 5$  1    $quantity = 3; //   $amount = $servicePrice * $quantity; //   - 15$   $returnUrl = 'http://your-site.com/subscription?status=paymentSuccess'; $customData = ['user_id' => $userId, 'service_id' => $serviceId ]; ?> <form id="createSubscription" action="<?php echo $payNowButtonUrl; ?>" method="post" target="_top"> <input type="hidden" name="cmd" value="_xclick-subscriptions"> <input type="hidden" name="business" value="<?php echo $receiverEmail; ?>"> <input type="hidden" name="lc" value="GB"> <input type="hidden" name="item_name" value="<?php echo $serviceName; ?>"> <input type="hidden" name="no_note" value="1"> <input type="hidden" name="no_shipping" value="1"> <input type="hidden" name="return" value="<?php echo $returnUrl; ?>"> <input type="hidden" name="src" value="1"> <input type="hidden" name="a3" value="<?php echo $amount; ?>"> <input type="hidden" name="p3" value="1"> <input type="hidden" name="t3" value="M"> <input id="customData" type="hidden" name="custom" value="<?php echo json_encode($customData); ?>"> <input type="hidden" name="currency_code" value="USD"> <button type="submit">Subscribe</button> </form>

サブスクリプション価格は、パラメーターa3によって設定されます。サブスクリプション期間は、パラメーターp3およびt3を使用して設定されます（この例では、支払いは毎月発生します）。

これらのパラメータおよびその他のパラメータの詳細な説明は、ドキュメントに記載されています。

IPN

IPNの場合、すべては基本的に1回限りの支払いと同じです。確かに、我々はより多くのリクエストを受け取るでしょうより多くのイベントを処理する必要があります：サブスクリプションの作成、サブスクリプションの支払い、サブスクリプションの解除など。前と同様に、各リクエストの信頼性を確認してから処理する必要があります。

サブスクリプション検証

ここでのすべては、1回限りの支払いよりも少し複雑です。支払いだけでなく、サブスクリプションの作成、サブスクリプションのキャンセル、サブスクリプションの変更も検証する必要があります。アプリケーションのロジックに応じて、おそらく他の何か。たとえば、Proの料金プランには最大100人のユーザーが必要です。またはそのような何か。繰り返しますが、フォームを作成する段階で、これらすべてを考慮に入れることができます。

この場合に正確に確認する必要があるもの：

キャンセルの場合は、サブスクリプションが存在することを確認してください
サブスクリプションで支払うには、それを確認してください
- 価格は0ではありません
- サブスクリプションのサイズに等しい支払い額
- 受信者が正しく指定されている
- 完了したサブスクリプションステータス
- 米ドル通貨
払い戻しの場合、支払いが存在し、払い戻し金額が支払い金額を超えていないことを確認する必要があります（部分払い戻しを行っている場合、払い戻し金額は支払いより少ない場合があります）
サブスクリプションを作成する場合、料金プランが存在し、価格が一致することを確認する必要があります

 <?php function validateSubscription($subscriptionPlan,$myPost){ $userId = $myPost['customData']['user_id']; $userService = new UserService(); $userInfo = $userService->getUserData($userId); $customData = $this->getCustomData($myPost); //    if($myPost['txn_type'] == 'subscr_cancel'){ $subscriptionService = new SubscriptionService(); $subscription = $subscriptionService->loadBySubscriptionId($myPost['subscr_id']); if(!$subscription->id){ //   return false; } } //   elseif($myPost['txn_type'] == 'subscr_payment'){ //    if($subscriptionPlan->price * $myPost['customData']['items_count'] != $myPost['mc_gross']){ return false; } // ,     0 if($myPost['mc_gross'] == 0){ return false; } //   if($myPost['receiver_email'] != 'xxx-facilitator@yandex.ru'){ return false; } //  if($myPost['mc_currency'] != 'USD'){ return false; } //   if($myPost['payment_status'] != 'Completed'){ return false; } } //   elseif($myPost['reason_code'] == 'refund' && $myPost['payment_status'] == 'Refunded'){ $transactionService = new TransactionService(); $lastTransaction = $transactionService->getLastActiveTransactionBySubscription($myPost['subscr_id']); //,    if(!$lastTransaction){ return false; } //,        if(abs($myPost['mc_gross']) > $lastTransaction['mc_gross']){ return false; } } return true; } ?>

支払い処理

検証に成功すると、支払いの処理を続行できます。ここには、いくつかの可能なサブスクリプション状態があります。

サブスクリプションは存在しません
有効なサブスクリプション
未登録

サブスクリプションのステータスに応じて、リクエストは異なる方法で処理されます。

 <?php function processPayment($myPost){ $customData = $this->getCustomData($myPost); $userId = $customData['user_id']; $userService = new UserService(); $userInfo = $userService->getUserData($userId); $subscriptionPlanService = new SubscriptionPlanService(); $subscriptionPlan = $subscriptionPlanService->getSubscriptionPlan($myPost); $transactionService = new TransactionService(); $subscriptionService = new SubscriptionService(); if(validateSubscription($subscriptionPlan,$myPost)){ $subscription = $subscriptionService->loadBySubscriptionId($myPost['subscr_id']); $transaction = $transactionService->getTransactionById($myPost['txn_id']); //  if($subscription->id){ //    if($myPost['txn_type'] == 'subscr_payment'){ //     if(!$transaction){ //   $subscription->status = 'active'; $subscription->payment_date = $myPost['payment_date']; $subscription->updated_date = date('Ymd H:i:s'); $subscription->save(); //   $myPost['relation_id'] = $subscription->id; $myPost['relation_type'] = 'transaction'; $transactionService->createTransaction($myPost); } else{ //  .     } } //   if($myPost['txn_type'] == 'subscr_cancel'){ $subscription->status = 'cancelled'; $subscription->updated_date = date('Ymd H:i:s'); $subscription->save(); } //   if($myPost['txn_type'] == 'subscr_eot'){ $subscription->status = 'expired'; $subscription->updated_date = date('Ymd H:i:s'); $subscription->save(); } //    if($myPost['txn_type'] == 'subscr_signup'){ } //       .  .     if($myPost['txn_type'] == 'subscr_modify'){ $subscription->status = 'modified'; $subscription->updated_date = date('Ymd H:i:s'); $subscription->save(); } //   if($myPost['payment_status'] == 'Refunded' && $myPost['reason_code'] == 'refund'){ //      $transactionService->updateTransactionStatus($myPost['parent_txn_id'],'Refunded'); //   () $myPost['txn_type'] = 'refund'; $myPost['relation_id'] = $subscription->id; $myPost['relation_type'] = 'subscription'; $transactionService->createTransaction($myPost); } } //    else{ //     if($myPost['txn_type'] == 'subscr_payment'){ $activeSubscriptions = $subscriptionService->getActiveSubscriptions($userId); // ,      . if(count($activeSubscriptions) > 0){ // ,        } elseif(!$transaction){ //   $subscription = new Subscription(); $subscription->user_id = $userId; $subscription->plan_id = $subscriptionPlan->id; $subscription->subscription_id = $myPost['subscr_id']; $subscription->created_date = date("Ymd H:i:s"); $subscription->updated_date = date('Ymd H:i:s'); $subscription->payment_date = $myPost['payment_date']; $subscription->items_count = $customData['items_count']; $subscription->status = 'active'; $subscriptionId = $subscription->save(); //   $myPost['relation_id'] = $subscriptionId; $myPost['relation_type'] = PaypalTransaction::TRANSACTION_RELATION_SUBSCRIPTION; $transactionService = new PaypalTransaction(); $transactionService->createTransaction($myPost); } else{ //    } } //  .      ,         if($myPost['txn_type'] == 'subscr_signup'){ } //  .     ..     if($myPost['txn_type'] == 'subscr_modify'){ } } } else{ //     } } ?>

登録解除

ユーザーがアプリケーションの使用にうんざりしている場合に備えて、サブスクリプションのキャンセルを実現します。この場合、Paypal Classic Apiを使用してサブスクリプションをキャンセルします。

APIを使用するには、ユーザー名、パスワード、署名が必要です。それらはプロファイル設定で見つけることができます。

購読解除はManageRecurringPaymentsProfileStatusメソッドを使用して行われます

 <?php // $profile_id - id  ( $myPost['subscr_id']) // $action - 'Cancel' public function changeSubscriptionStatus($profile_id, $action, $apiCredentials){ $api_request = 'USER=' . urlencode( $apiCredentials['username'] ) . '&PWD=' . urlencode( $apiCredentials['password'] ) . '&SIGNATURE=' . urlencode( $apiCredentials['signature'] ) . '&VERSION=76.0' . '&METHOD=ManageRecurringPaymentsProfileStatus' . '&PROFILEID=' . urlencode( $profile_id ) . '&ACTION=' . urlencode( $action ) . '&NOTE=' . urlencode( 'Profile cancelled at store' ); $ch = curl_init(); curl_setopt( $ch, CURLOPT_URL, 'https://api-3t.sandbox.paypal.com/nvp' ); // For live transactions, change to 'https://api-3t.paypal.com/nvp' curl_setopt( $ch, CURLOPT_VERBOSE, 1 ); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 1); curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 ); curl_setopt( $ch, CURLOPT_POST, 1 ); // Set the API parameters for this transaction curl_setopt( $ch, CURLOPT_POSTFIELDS, $api_request ); // Request response from PayPal $response = curl_exec( $ch ); // If no response was received from PayPal there is no point parsing the response if( ! $response ){ return false; } curl_close( $ch ); // An associative array is more usable than a parameter string parse_str( $response, $parsed_response ); return $parsed_response; } ?>

この方法にはいくつかの問題があります。既にキャンセルされているサブスクリプションはキャンセルできません。ただし、サブスクリプションのステータスも確認できません。したがって、サブスクリプションを常にキャンセルする必要があります（通常の状況では、サブスクリプションを2回キャンセルする必要はありません）。この問題はこの投稿で説明されています。

払い戻し（全額/一部）

おそらく、サブスクリプションのキャンセルに加えて、ユーザーは未使用期間のお金を返したいと考えています（注：1か月間購読、1週間後にキャンセル-費用の75％を返す必要があります）。

Paypal Classic ApiのRefundTransactionメソッドも使用できます。

 <?php // $transaction_id - $myPost['txn_id'] // $amount -    public function refundTransaction($transaction_id,$apiCredentials$amount = null){ $transaction_id = $transaction['txn_id']; $refundType = 'Full'; if($amount){ $amount = round($amount, 2, PHP_ROUND_HALF_DOWN); $amount = str_replace(',','.',$amount); $refundType = 'Partial'; } $api_request = 'USER=' . urlencode( $apiCredentials['username'] ) . '&PWD=' . urlencode( $apiCredentials['password'] ) . '&SIGNATURE=' . urlencode( $apiCredentials['signature'] ) . '&VERSION=119' . '&METHOD=RefundTransaction' . '&TRANSACTIONID=' . urlencode( $transaction_id ) . '&REFUNDTYPE=' . urlencode( $refundType ) . '&CURRENCYCODE=' . urlencode( 'USD' ); if($amount){ $api_request .= '&AMT=' . urlencode( $amount ); } $ch = curl_init(); curl_setopt( $ch, CURLOPT_URL, 'https://api-3t.sandbox.paypal.com/nvp' ); // For live transactions, change to 'https://api-3t.paypal.com/nvp' curl_setopt( $ch, CURLOPT_VERBOSE, 1 ); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 1); curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 ); curl_setopt( $ch, CURLOPT_POST, 1 ); // Set the API parameters for this transaction curl_setopt( $ch, CURLOPT_POSTFIELDS, $api_request ); // Request response from PayPal $response = curl_exec( $ch ); // If no response was received from PayPal there is no point parsing the response if( ! $response ){ return false; } curl_close( $ch ); // An associative array is more usable than a parameter string parse_str( $response, $parsed_response ); return $parsed_response; } ?>

収益額を計算するには、次のコードを使用できます。コードは、毎月のサブスクリプションリターンを計算するように設計されています。

 <?php public static function getTransactionRefundAmount($transaction){ $paymentDate = date('Ym-d',strtotime($transaction['payment_date'])); $currentDate = date('Ym-d'); $paymentDate = new DateTime($paymentDate); $currentDate = new DateTime($currentDate); $dDiff = $paymentDate->diff($currentDate); $days = $dDiff->days; $daysInMonth = cal_days_in_month(CAL_GREGORIAN,$currentDate->format('m'),$currentDate->format('Y')); $amount = $transaction['mc_gross'] - $transaction['mc_gross'] * $days / $daysInMonth; $amount = round($amount, 2, PHP_ROUND_HALF_DOWN); $amount = str_replace(',','.',$amount); return $amount; } ?>

サブスクリプションを変更する

次に、サブスクリプションの条件を変更する機能を追加します。これは、ユーザーが料金プランまたはユーザー数を変更する場合に必要になります。残念ながら、PayPalはサブスクリプションの変更に特定の制限を課しています。

ここでは、この問題について説明します。

私は自分でこの情報を確認したくありません。同時に、ユーザーが料金プランを変更したい場合もあり、サブスクリプションのコストは大幅に変わります。この場合、まず現在のサブスクリプションをキャンセルし、部分的な払い戻しを行うことができます。次に、他のパラメーターを使用して新しいサブスクリプションを作成します。

おそらくそれほど美しくはありませんが、完璧に機能します。その結果、私はこのオプションに決めました。ただし、原則として、上記のリンクには、サブスクリプションの変更をより正確にする方法に関する情報が含まれています。

おわりに

その結果、1回限りの支払いとPaypalサブスクリプションで作業する機会が得られます。1回限りのサブスクリプション支払いを処理するためのロジックは、Webアプリケーションにあります。

時間が経つにつれて、新しい料金プランを追加し、古い料金プランを変更することができます（これを慎重に行う、検証を確認するなど）。

これで話は終わりです。ご清聴ありがとうございました。この記事がお役に立てば幸いです。コメントで質問に答えてうれしいです。

UPDは：ありがとう、Daniyar94を。IPNに加えてPDTを使用できます。これは、支払いの成功に関するメッセージをすぐに表示するのに役立ちます。詳細はこちらhabrahabr.ru/post/266091/#comment_8560801

Paypal経由の支払いをウェブアプリケーションに統合します

アカウント作成

サンドボックスアカウントの作成

Paypalのセットアップ

一回払い

データ構造

お支払い方法

即時支払い通知（IPN）

支払い処理

支払い検証

サブスクリプション

サブスクリプションフォーム

IPN

サブスクリプション検証

支払い処理

登録解除

払い戻し（全額/一部）

サブスクリプションを変更する

おわりに

More articles: