PayPal支付完整教程：Checkout收银台与Subscription订阅计划

Subscribe to linli

<100 subscribers

Subscribe to linli

<100 subscribers

本文详细介绍了如何使用PayPal支付接口，包括Checkout收银台支付与Subscription订阅支付计划的完整流程。我们将一步步解析这些支付过程，帮助您顺利实现集成。

一、生命周期解析

1. Checkout - 收银台支付

下面是Checkout支付的流程图，类似于支付宝的收银台支付：

Checkout流程

流程详解：

本地应用组装好参数并请求Checkout接口，接口同步返回一个支付URL；
本地应用重定向至此URL，用户登录PayPal账户并确认支付，支付后跳转到设置好的本地应用地址；
本地请求PayPal执行付款接口发起扣款；
PayPal发送异步通知至本地应用，本地收到数据包后进行验签；
验签成功后，执行支付后的业务，如修改订单状态、增加销量、发送邮件等。

2. Subscription - 订阅支付

下面是Subscription支付的流程图：

Subscription流程

流程详解：

创建一个订阅计划；
激活该计划；
使用激活的计划创建订阅申请；
用户授权并完成第一期付款，支付后携带token跳转至设置好的本地应用地址；
回跳后请求执行订阅；
收到订阅授权的异步回调，验证支付结果，执行支付完成后的业务。

二、具体实现

Checkout流程

在项目中安装PayPal SDK

$ composer require paypal/rest-api-sdk-php:*  // 使用最新版本

创建PayPal配置文件

$ touch config/paypal.php

配置文件内容如下（包括沙箱与生产环境的配置）：

<?php

return [
    'sandbox' => [
        'client_id' => env('PAYPAL_SANDBOX_CLIENT_ID', ''),
        'secret' => env('PAYPAL_SANDBOX_SECRET', ''),
        'notify_web_hook_id' => env('PAYPAL_SANDBOX_NOTIFY_WEB_HOOK_ID', ''),
    ],

    'live' => [
        'client_id' => env('PAYPAL_CLIENT_ID', ''),
        'secret' => env('PAYPAL_SECRET', ''),
        'notify_web_hook_id' => env('PAYPAL_NOTIFY_WEB_HOOK_ID', ''),
    ],
];

创建PayPal服务类

$ mkdir -p app/Services && touch app/Services/PayPalService.php

代码实现

使用PayPal API来执行支付与订阅。以下是服务类的部分代码：

namespace App\Services;

use PayPal\Api\Currency;
use PayPal\Api\Payment;
use PayPal\Api\RedirectUrls;
use PayPal\Api\Transaction;
use PayPal\Api\Payer;
use PayPal\Api\Amount;
use PayPal\Api\ItemList;
use PayPal\Api\Item;
use PayPal\Api\PaymentExecution;
use Symfony\Component\HttpKernel\Exception\HttpException;

class PayPalService
{
    public function checkout(Order $order)
    {
        try {
            $payer = new Payer();
            $payer->setPaymentMethod('paypal');

            $item = new Item();
            $item->setName($order->product->title)
                ->setDescription($order->no)
                ->setCurrency($order->product->currency)
                ->setQuantity(1)
                ->setPrice($order->total_amount);

            $itemList = new ItemList();
            $itemList->setItems([$item]);

            $details = new Details();
            $details->setShipping(0)
                    ->setSubtotal($order->total_amount);

            $amount = new Amount();
            $amount->setCurrency($order->product->currency)
                   ->setTotal($order->total_amount)
                   ->setDetails($details);

            $transaction = new Transaction();
            $transaction->setAmount($amount)
                        ->setItemList($itemList)
                        ->setDescription($order->no)
                        ->setInvoiceNumber(uniqid());

            $redirectUrls = new RedirectUrls();
            $redirectUrls->setReturnUrl(route('payment.paypal.return', ['success' => 'true', 'no' => $order->no]))
                         ->setCancelUrl(route('payment.paypal.return', ['success' => 'false', 'no' => $order->no]));

            $payment = new Payment();
            $payment->setIntent('sale')
                    ->setPayer($payer)
                    ->setRedirectUrls($redirectUrls)
                    ->setTransactions([$transaction]);

            $payment->create($this->apiContext);

            return $payment->getApprovalLink();
        } catch (HttpException $e) {
            Log::error('PayPal Checkout Create Failed', ['msg' => $e->getMessage(), 'code' => $e->getStatusCode()]);
            return null;
        }
    }
}

订阅流程

创建订阅计划并激活

public function createPlan(Order $order)
{
    try {
        $plan = new Plan();
        $plan->setName($order->no)
             ->setDescription($order->product->title)
             ->setType('INFINITE');

        $paymentDefinition = new PaymentDefinition();
        $paymentDefinition->setAmount(new Currency([
            'value' => $order->product->price,
            'currency' => $order->product->currency
        ]));

        $plan->setPaymentDefinitions([$paymentDefinition]);
        $plan->create($this->apiContext);

        $patch = new Patch();
        $value = new PayPalModel('{"state":"ACTIVE"}');
        $patch->setOp('replace')
              ->setPath('/')
              ->setValue($value);
        $patchRequest = new PatchRequest();
        $patchRequest->addPatch($patch);
        $plan->update($patchRequest, $this->apiContext);

        return Plan::get($plan->getId(), $this->apiContext);
    } catch (HttpException $e) {
        Log::error('PayPal Create Plan Failed', ['msg' => $e->getMessage()]);
        return false;
    }
}

常见问题

微软邮箱问题：使用outlook、hotmail、live等邮箱注册PayPal账户，升级至GPT Plus或绑定API后会出现账户封禁的问题，建议避免使用这些邮箱。
排队等待问题：若在PayPal升级页面看到排队提示，可以尝试使用提供的链接直接进入升级页面，避免排队。
取消自动续费：PayPal订阅会默认自动续费，确保在不再需要订阅时手动取消自动续费设置。

☞ WildCard | 一分钟注册，轻松订阅海外线上服务使用门槛极低，微信支付宝均可开通使用。支持开通各类海外平台：ChatGPT、Claude、Google Play、Apple Store、OpenAI、X、Patreon、MidJourney、Amazon、POE、Microsoft、Facebook、GitHub、Telegram、PayPal等各类海淘订阅平台。使用邀请码：ACCPAY，立享消费0手续费，减免开卡费用。

一、生命周期解析

1. Checkout - 收银台支付

下面是Checkout支付的流程图，类似于支付宝的收银台支付：

Checkout流程

流程详解：

本地应用组装好参数并请求Checkout接口，接口同步返回一个支付URL；
本地应用重定向至此URL，用户登录PayPal账户并确认支付，支付后跳转到设置好的本地应用地址；
本地请求PayPal执行付款接口发起扣款；
PayPal发送异步通知至本地应用，本地收到数据包后进行验签；
验签成功后，执行支付后的业务，如修改订单状态、增加销量、发送邮件等。

2. Subscription - 订阅支付

下面是Subscription支付的流程图：

Subscription流程

流程详解：

创建一个订阅计划；
激活该计划；
使用激活的计划创建订阅申请；
用户授权并完成第一期付款，支付后携带token跳转至设置好的本地应用地址；
回跳后请求执行订阅；
收到订阅授权的异步回调，验证支付结果，执行支付完成后的业务。

二、具体实现

Checkout流程

在项目中安装PayPal SDK

$ composer require paypal/rest-api-sdk-php:*  // 使用最新版本

创建PayPal配置文件

$ touch config/paypal.php

配置文件内容如下（包括沙箱与生产环境的配置）：

<?php

return [
    'sandbox' => [
        'client_id' => env('PAYPAL_SANDBOX_CLIENT_ID', ''),
        'secret' => env('PAYPAL_SANDBOX_SECRET', ''),
        'notify_web_hook_id' => env('PAYPAL_SANDBOX_NOTIFY_WEB_HOOK_ID', ''),
    ],

    'live' => [
        'client_id' => env('PAYPAL_CLIENT_ID', ''),
        'secret' => env('PAYPAL_SECRET', ''),
        'notify_web_hook_id' => env('PAYPAL_NOTIFY_WEB_HOOK_ID', ''),
    ],
];

创建PayPal服务类

$ mkdir -p app/Services && touch app/Services/PayPalService.php

代码实现

使用PayPal API来执行支付与订阅。以下是服务类的部分代码：

namespace App\Services;

use PayPal\Api\Currency;
use PayPal\Api\Payment;
use PayPal\Api\RedirectUrls;
use PayPal\Api\Transaction;
use PayPal\Api\Payer;
use PayPal\Api\Amount;
use PayPal\Api\ItemList;
use PayPal\Api\Item;
use PayPal\Api\PaymentExecution;
use Symfony\Component\HttpKernel\Exception\HttpException;

class PayPalService
{
    public function checkout(Order $order)
    {
        try {
            $payer = new Payer();
            $payer->setPaymentMethod('paypal');

            $item = new Item();
            $item->setName($order->product->title)
                ->setDescription($order->no)
                ->setCurrency($order->product->currency)
                ->setQuantity(1)
                ->setPrice($order->total_amount);

            $itemList = new ItemList();
            $itemList->setItems([$item]);

            $details = new Details();
            $details->setShipping(0)
                    ->setSubtotal($order->total_amount);

            $amount = new Amount();
            $amount->setCurrency($order->product->currency)
                   ->setTotal($order->total_amount)
                   ->setDetails($details);

            $transaction = new Transaction();
            $transaction->setAmount($amount)
                        ->setItemList($itemList)
                        ->setDescription($order->no)
                        ->setInvoiceNumber(uniqid());

            $redirectUrls = new RedirectUrls();
            $redirectUrls->setReturnUrl(route('payment.paypal.return', ['success' => 'true', 'no' => $order->no]))
                         ->setCancelUrl(route('payment.paypal.return', ['success' => 'false', 'no' => $order->no]));

            $payment = new Payment();
            $payment->setIntent('sale')
                    ->setPayer($payer)
                    ->setRedirectUrls($redirectUrls)
                    ->setTransactions([$transaction]);

            $payment->create($this->apiContext);

            return $payment->getApprovalLink();
        } catch (HttpException $e) {
            Log::error('PayPal Checkout Create Failed', ['msg' => $e->getMessage(), 'code' => $e->getStatusCode()]);
            return null;
        }
    }
}

订阅流程

创建订阅计划并激活

public function createPlan(Order $order)
{
    try {
        $plan = new Plan();
        $plan->setName($order->no)
             ->setDescription($order->product->title)
             ->setType('INFINITE');

        $paymentDefinition = new PaymentDefinition();
        $paymentDefinition->setAmount(new Currency([
            'value' => $order->product->price,
            'currency' => $order->product->currency
        ]));

        $plan->setPaymentDefinitions([$paymentDefinition]);
        $plan->create($this->apiContext);

        $patch = new Patch();
        $value = new PayPalModel('{"state":"ACTIVE"}');
        $patch->setOp('replace')
              ->setPath('/')
              ->setValue($value);
        $patchRequest = new PatchRequest();
        $patchRequest->addPatch($patch);
        $plan->update($patchRequest, $this->apiContext);

        return Plan::get($plan->getId(), $this->apiContext);
    } catch (HttpException $e) {
        Log::error('PayPal Create Plan Failed', ['msg' => $e->getMessage()]);
        return false;
    }
}

常见问题

微软邮箱问题：使用outlook、hotmail、live等邮箱注册PayPal账户，升级至GPT Plus或绑定API后会出现账户封禁的问题，建议避免使用这些邮箱。
排队等待问题：若在PayPal升级页面看到排队提示，可以尝试使用提供的链接直接进入升级页面，避免排队。
取消自动续费：PayPal订阅会默认自动续费，确保在不再需要订阅时手动取消自动续费设置。

More from linli

More from linli

No activity yet

linli

More from linli

No activity yet

More from linli

PayPal支付完整教程：Checkout收银台与Subscription订阅计划

PayPal支付完整教程：Checkout收银台与Subscription订阅计划

一、生命周期解析

1. Checkout - 收银台支付

流程详解：

2. Subscription - 订阅支付

流程详解：

二、具体实现

Checkout流程

在项目中安装PayPal SDK

创建PayPal配置文件

创建PayPal服务类

代码实现

订阅流程

创建订阅计划并激活

常见问题

一、生命周期解析

1. Checkout - 收银台支付

流程详解：

2. Subscription - 订阅支付

流程详解：

二、具体实现

Checkout流程

在项目中安装PayPal SDK

创建PayPal配置文件

创建PayPal服务类

代码实现

订阅流程

创建订阅计划并激活

常见问题

No activity yet

No activity yet