paypal 简单开发接口demo


如果我们的应用是面向国际的、那么支付的时候通常会考虑使用paypal。以下为个人写的一个paypal支付示例,已亲测可行。

一、开发前准备

  • https://developer.paypal.com/  到paypal的开发者官网注册开发者账号。
  • 用账号登录之后、点击导航上面的 dashboard、进入dashboard面版。如下截图、后续的操作都是在这个面板中操作。
  • \
  • 上面截图中菜单 Sandbox下面的Accounts里面能看到你的 sandbox测试的买家账号和卖家账号。2个测试账号里面都有profile选项里面有changepassword可以设置虚拟账号的密码。
  • 上面截图中菜单Sandbox下面的Transactions就是你的交易记录。
  • 点击截图页面右上角的 Create App按钮。创建一个应用。创建好后、会给你提供一个Client ID 和 Secret。这两个可以配置为php常量后面开发中会用到。

二、进入支付Demo开发

  • 随便在本地建立一个开发代码根目录、先建立一个index.html里面就放一个简单的产品名称和产品价格两个input项即可、代码和截图如下:
  • 复制代码
    DOCTYPE html>
    <html lang="en">
        <head>
            <meta charset="utf-8">
            <title>支付页面title>
        head>
        <body>
            <div>
                <form action="checkout.php" method="post" autocomplete="off">
                    <label for="item">
                        产品名称
                        <input type="text" name="product">
                    label>
                    <br>
                    <label for="amount">
                        价格
                        <input type="text" name="price">
                    label>
                    <br>
                    <input type="submit" value="去付款">
                form>
            div>
        body>
    html>
    复制代码

    \

  • 输入产品名称 和 价格。点击去付款就会到paypal的付款页面。用你的sandbox测试买家账号去付款。就会发现付款成功。然后登陆你的测试卖家账号。会发现卖家账号已经收到付款。当然这里会扣除paypal收取的手续费。手续费收的是卖家的。
  • 下面来具体看看php是怎么实现的。首先先要把paypal提供的 php-sdk给弄到你的代码目录中来。这里介绍使用php的包管理器composer来获取最新sdk、当然你可以可以从github等其他渠道获取最新的paypal php-sdk。
  • 默认你的电脑已经安装composer了。如果没有自己去度娘或者google下composer安装。
  • 然后在你的代码根目录写一个composer.json文件来获取包内容。json文件代码如下:
    {
        "require" : {
            "paypal/rest-api-sdk-php" : "1.5.1"
        }
    }

    这里如果是 linux/unix系统就直接再根目录执行composer install来获取包内容。

  • 安装好之后。根目录下面会产生一个vendor目录。里面有composer 和 paypal两个子目录。composer里面实现了自动加载、paypal则是你的sdk内容。
  • 接下来我们来写一个公共文件(这里默认用 app/start.php、你的项目中可以自定义)、其实里面就只是实现了 sdk的autoload.php自动加载 和 创建刚才上面的的client id  和 secret生成的paypal支付对象实例。start.php代码如下:
  • 复制代码
    php
    require "vendor/autoload.php"; //载入sdk的自动加载文件
    define('SITE_URL', 'http://www.paydemo.com'); //网站url自行定义
    //创建支付对象实例
    $paypal = new \PayPal\Rest\ApiContext(
        new \PayPal\Auth\OAuthTokenCredential(
            '你的Client ID'
            '你的secret'
        )
    );
    复制代码
  • 接下来就来实现表单中提交的处理文件 checkout.php。代码内容如下:
  • 复制代码
    php
    /**
     * @author xxxxxxxx
     * @brief 简介:
     * @date 15/9/2
     * @time 下午5:00
     */
    use \PayPal\Api\Payer;
    use \PayPal\Api\Item;
    use \PayPal\Api\ItemList;
    use \PayPal\Api\Details;
    use \PayPal\Api\Amount;
    use \PayPal\Api\Transaction;
    use \PayPal\Api\RedirectUrls;
    use \PayPal\Api\Payment;
    use \PayPal\Exception\PayPalConnectionException;
    
    require "app/start.php";
    if (!isset($_POST['product'], $_POST['price'])) {
        die("lose some params");
    }
    $product = $_POST['product'];
    $price = $_POST['price'];
    $shipping = 2.00; //运费
    
    $total = $price + $shipping;
    
    $payer = new Payer();
    $payer->setPaymentMethod('paypal');
    
    $item = new Item();
    $item->setName($product)
        ->setCurrency('USD')
        ->setQuantity(1)
        ->setPrice($price);
    
    $itemList = new ItemList();
    $itemList->setItems([$item]);
    
    $details = new Details();
    $details->setShipping($shipping)
        ->setSubtotal($price);
    
    $amount = new Amount();
    $amount->setCurrency('USD')
        ->setTotal($total)
        ->setDetails($details);
    
    $transaction = new Transaction();
    $transaction->setAmount($amount)
        ->setItemList($itemList)
        ->setDescription("支付描述内容")
        ->setInvoiceNumber(uniqid());
    
    $redirectUrls = new RedirectUrls();
    $redirectUrls->setReturnUrl(SITE_URL . '/pay.php?success=true')
        ->setCancelUrl(SITE_URL . '/pay.php?success=false');
    
    $payment = new Payment();
    $payment->setIntent('sale')
        ->setPayer($payer)
        ->setRedirectUrls($redirectUrls)
        ->setTransactions([$transaction]);
    
    try {
        $payment->create($paypal);
    } catch (PayPalConnectionException $e) {
        echo $e->getData();
        die();
    }
    
    $approvalUrl = $payment->getApprovalLink();
    header("Location: {$approvalUrl}");
    复制代码

    checkout.php通过表单提交上来的参数对支付具体细节和参数进行初始化和设置。这里只列出了常用的部分。paypal提供了很多参数设置。具体更丰富的可以自己参考paypal官方开发者文档。

  • checkout.php设置完参数之后。会生成一个支付链接。用header跳转到这个支付链接(就是paypal的支付页面)到这个支付页面上面就可以用你的sandbox提供的buyer账号去支付了。截图如下:
  • \
  • 用buyer账号支付完成之后。去看看你的sandbox的商家账户余额吧。就会发现已经收到了扣除手续费外的钱了。
  • 这里支付成功 或者 失败后还有一个回调的处理。回调处理的php文件再上面的checkout.php里面的setReturnUrl处设置。这里设置的是/pay.php?success=true 
  • 接下来我们来看看pay.php是怎么简单处理回调的。先贴上pay.php的代码:
  • 复制代码
    php
    
    require 'app/start.php';
    
    use PayPal\Api\Payment;
    use PayPal\Api\PaymentExecution;
    
    if(!isset($_GET['success'], $_GET['paymentId'], $_GET['PayerID'])){
        die();
    }
    
    if((bool)$_GET['success']=== 'false'){
    
        echo 'Transaction cancelled!';
        die();
    }
    
    $paymentID = $_GET['paymentId'];
    $payerId = $_GET['PayerID'];
    
    $payment = Payment::get($paymentID, $paypal);
    
    $execute = new PaymentExecution();
    $execute->setPayerId($payerId);
    
    try{
        $result = $payment->execute($execute, $paypal);
    }catch(Exception $e){
        die($e);
    }
    echo '支付成功!感谢支持!';
    复制代码

    好了。到这里一个简单的paypal支付的demo其实已经走通了。懂得支付原理之后、想要再你自己的项目里面进行更丰富的扩展、就去paypal的官方文档查看更多具体的开发项设置。包括交易明细的获取等等都是可以实现的。这里就不具体讲下去了。

  • 原文地址

...more

  • Author

    12 days ago | Profile | #

    Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.