接入 paypal PHP-sdk 支付 / 回调 / 退款全流程

记录一下接入paypal 全过程

因项目的原因要用到国外的支付和国外的信用卡,查了一下paypal就内置了信用卡付款方式,所以只需要接入paypal就能基本满足项目海外支付的需求。

查了一下文档发现web端可以接入js的支付和服务端sdk的支付,这里选择了php-sdk支付

一. 下载sdk

在composer.json中加入 "paypal/rest-api-sdk-php" : "1.7.4"

接入 paypal PHP-sdk 的流程

在命令行中运行 composer update

二. 注册开发者帐号、创建应用

地址:https://developer.paypal.com

创建沙盒测试账户(注册时会自动生成一个个人账户和商家账户,如果不能使用就自己创建几个):https://developer.paypal.com/developer/acc...

1. 创建应用

接入 paypal PHP-sdk 的流程

2. 获取应用配置

接入 paypal PHP-sdk 的流程
shndbox为沙盒环境配置,live反之

3. 创建测试帐号

接入 paypal PHP-sdk 的流程

点击create account设置测试帐号金额和密码

三.代码

调起paypal支付

<?php

namespace App\Http\Controllers\Api;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;

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\Auth\OAuthTokenCredential;
use PayPal\Exception\PayPalConnectionException;
use PayPal\Rest\ApiContext;
use PayPal\Api\PaymentExecution;

class paypalController extends Controller
{
    const clientId = 'xxxxxxxxx';//ID
    const clientSecret = 'xxxxxxxx';//秘钥
    const accept_url = 'http://laravel-rbac.cc/Api/paypal/Callback';//返回地址
    const Currency = 'USD';//币种
    protected $PayPal;

    public function __construct()
    {
        $this->PayPal = new ApiContext(
            new OAuthTokenCredential(
                self::clientId,
                self::clientSecret
            )
        );
        //如果是沙盒测试环境不设置,请注释掉
//        $this->PayPal->setConfig(
//            array(
//                'mode' => 'live',
//            )
//        );
    }

    /**
     * @param
     * $product 商品
     * $price 价钱
     * $shipping 运费
     * $description 描述内容
     */
    public function pay()
    {
        $product = '1123';
        $price = 1;
        $shipping = 0;
        $description = '1123123';
        $paypal = $this->PayPal;
        $total = $price + $shipping;//总价

        $payer = new Payer();
        $payer->setPaymentMethod('paypal');

        $item = new Item();
        $item->setName($product)->setCurrency(self::Currency)->setQuantity(1)->setPrice($price);

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

        $details = new Details();
        $details->setShipping($shipping)->setSubtotal($price);

        $amount = new Amount();
        $amount->setCurrency(self::Currency)->setTotal($total)->setDetails($details);

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

        $redirectUrls = new RedirectUrls();
        $redirectUrls->setReturnUrl(self::accept_url . '?success=true')->setCancelUrl(self::accept_url . '/?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}");
    }

接入 paypal PHP-sdk 的流程

同步回调 - 用于确认用户是否付款

    /**
     * 回调
     */
    public function Callback()
    {
        $success = trim($_GET['success']);

        if ($success == 'false' && !isset($_GET['paymentId']) && !isset($_GET['PayerID'])) {
            echo '取消付款';die;
        }

        $paymentId = trim($_GET['paymentId']);
        $PayerID = trim($_GET['PayerID']);

        if (!isset($success, $paymentId, $PayerID)) {
            echo '支付失败';die;
        }

        if ((bool)$_GET['success'] === 'false') {
            echo  '支付失败,支付ID【' . $paymentId . '】,支付人ID【' . $PayerID . '】';die;
        }

        $payment = Payment::get($paymentId, $this->PayPal);

        $execute = new PaymentExecution();

        $execute->setPayerId($PayerID);

        try {
            $payment->execute($execute, $this->PayPal);
        } catch (Exception $e) {
            echo ',支付失败,支付ID【' . $paymentId . '】,支付人ID【' . $PayerID . '】';die;
        }
        echo '支付成功,支付ID【' . $paymentId . '】,支付人ID【' . $PayerID . '】';die;
    }

异步回调 - 用于处理业务逻辑

要先在控制面板设置回调地址,必须为Https,设置后要等一会才会生效
接入 paypal PHP-sdk 的流程

  public function notify(){

        //获取回调结果
        $json_data = $this->get_JsonData();

        if(!empty($json_data)){
             Log::debug("paypal notify info:\r\n".json_encode($json_data));
        }else{
            Log::debug("paypal notify fail:参加为空");
        }
          //自己打印$json_data的值看有那些是你业务上用到的
          //比如我用到
          $data['invoice'] = $json_data['resource']['invoice_number'];
          $data['txn_id'] = $json_data['resource']['id'];
          $data['total'] = $json_data['resource']['amount']['total'];
          $data['status'] = isset($json_data['status'])?$json_data['status']:'';
          $data['state'] = $json_data['resource']['state'];

        try {
                 //处理相关业务
        } catch (\Exception $e) {
            //记录错误日志
            Log::error("paypal notify fail:".$e->getMessage());

            return "fail";
        }
        return "success";
    }

    public function get_JsonData(){
        $json = file_get_contents('php://input');
        if ($json) {
            $json = str_replace("'", '', $json);
            $json = json_decode($json,true);
        }
        return $json;
    }

退款

   public function returnMoney()
    {

        try {
            $txn_id = "xxxxxxx";  //异步加调中拿到的id
            $amt = new Amount();
            $amt->setCurrency('USD')
                ->setTotal('99');  // 退款的费用

            $refund = new Refund();
            $refund->setAmount($amt);

            $sale = new Sale();
            $sale->setId($txn_id);

            $refundedSale = $sale->refund($refund, $this->PayPal);
        } catch (\Exception $e) {
            // PayPal无效退款
            return json_decode(json_encode(['message' => $e->getMessage(), 'code' => $e->getCode(), 'state' => $e->getMessage()]));  // to object
        }
        // 退款完成
        return $refundedSale; 
    }

查看相关流水

支付成为后到测试帐号里查看流水https://www.sandbox.paypal.com/myaccount/home

接入 paypal PHP-sdk 的流程

结语

Paypal 由于是英文文档查了很多博客结合着文档来做的,下面是
php-sdk文档的地址:
http://paypal.github.io/PayPal-PHP-SDK/

本作品采用《CC 协议》,转载必须注明作者和本文链接

未经允许禁止转载 -- 苦力小林,

本帖由系统于 10个月前 自动加精
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
讨论数量: 42

全过程已补上,可能是全网最全的中文接放流程

11个月前 评论

@Double-Jin 不用谦虚了,肯定是最全的了。这个可能让我想起一个人

10个月前 评论

@Leon-myfriend 做的时候其实是查了全百度和google的,以上的功能都是实现了的,就是要找到一个能用的很难,我把他们实现后放在一起了而已

10个月前 评论

@Double-Jin "paypal/rest-api-sdk-php" : "1.7.4" 扩展包安装不上

10个月前 评论

@Leon-myfriend 一搬是Php版本不对,你上这查查https://packagist.org/packages/paypal/rest-api-sdk-php

10个月前 评论
houmuxu

路过支持

10个月前 评论
sssword

马克

10个月前 评论

@Double-Jin 7.1不行,切换到7.2就好了

10个月前 评论

@Leon-myfriend 我7.2paypal包会报错,7.1不会。。。。

10个月前 评论

您好 我是一个新手 paypal支付我困扰了好久 能麻烦您加下我微信帮忙解决一下么 17706343618

9个月前 评论

@phplioner 你说一下你的问题先

9个月前 评论

在沙盒环境下是正常的,但是在正式环境下提示error_description":"Client Authentication failed

9个月前 评论

@hezhizheng 做的时候有参考过他的,但调起支付的实现是不一样的,他的h5调转网页,我是请求链接还回再跳转

9个月前 评论

@hezhizheng 噢,原来是那篇文章的作者,你好,我在你那评论过的

file

9个月前 评论
fatrbaby

厉害,我接入过国外好多支付网关管。比如Paypal、2Checkout、Fastspring,发现没一个文档像样的。Stripe倒不错,不过我们申请不下来Stripe。

9个月前 评论

@fatrbaby 国内的支付接收入比较简单

9个月前 评论

请问设置那个异步回调地址是要多久才能生效的 我设置了几个小时都没生效

9个月前 评论

@li8483468 我第一次设的时候也是不生效,第二天才可以,当然也不排除你操作错了

9个月前 评论

@Double-Jin 为什么我测试付款完后的 状态是 “待处理”, 哪个环节出错了? 还需要收款方确认吗?

8个月前 评论

@qweasd123123 看下是否回调正常,再到付款帐户和商家帐户看下状态

8个月前 评论
qweasd123123 8个月前
Double-Jin (作者) (楼主) 8个月前
lji123123

通知那部分代码直接获取输入流,沒有验签吗?

//获取回调结果
        $json_data = $this->get_JsonData();

那如果我伪造请求是否会造成业务逻辑的漏洞?
还是说验证部分没放出来?

8个月前 评论
Double-Jin (楼主) 8个月前
lji123123 (作者) 8个月前
Double-Jin (楼主) 8个月前

file
为什么我同步付款成功后,回调的状态确是pending.

8个月前 评论
jasonjiang123 3周前

@qweasd123123 这个我不清楚哟,这个问题要发邮件给paypal可能才有回复

8个月前 评论
lji123123

@qweasd123123 你用你sandbox下面的BUSINESS賬號去sandbox.paypal.com登入,然後裡面的交易記錄裡面點接受這筆款項,paypal才會發起通知。

而且這個通知需要配置好webhook的地址確保能訪問到。

貌似還需要打開IPN的配置,我卡在IPN通知上了。
https://www.evoluted.net/thinktank/web-dev...
這個連接可以參考一下。

8个月前 评论
lji123123

@qweasd123123 你是怎麼配置webhook的可以參考一下嗎?

8个月前 评论
Double-Jin (楼主) 8个月前
lji123123 (作者) 8个月前
Double-Jin (楼主) 8个月前
lji123123 (作者) 8个月前
EternalSun 7个月前
lji123123

已經解決所有的問題了。

8个月前 评论

paypal 逐渐流行,学习了

8个月前 评论
Double-Jin (楼主) 8个月前
Rouyi (作者) 8个月前

厉害了 十分清晰 完爆全网 请问大佬什么时候发个V2版本的 我看手册上已经出V2了 但是SDK好像还没有更新啊

8个月前 评论
Double-Jin (楼主) 7个月前

Got Http response code 404 when accessing https://api.sandbox.paypal.com/v1/payments.... 退款时报错 使用的sale.php下 refundSale方法

file

8个月前 评论
Double-Jin (楼主) 7个月前

你好 想问下直接在webhook 那里设置异步地址吗 我现在遇到的问题是 异步没有走

8个月前 评论
Double-Jin (楼主) 7个月前
EternalSun 7个月前
Double-Jin (楼主) 7个月前

最近在接ebay的,想找找看,然后就看到你的paypal

7个月前 评论

我的webhook在测试环境 接收的到异步通知 在正式环境无法接收 我看测试环境配置的webhookid clientserct什么的是不一样的 查找不到原因 我在webhook那边代码打日志 发现日志没内容 我才推断的没有接收到通知 现在都是手动去查询那些处理中的订单完成支付 其实在用户那边paypal已经扣完钱了 最近发现很多人在网站上拉起paypal订单但是不支付不知道是不是这个对我的通知接收有影响啊

7个月前 评论
7NIAO

一直报错
sizeof(): Parameter must be an array or an object that implements Countable

6个月前 评论
franktrue

咨询一下,PayPal不会像微信或支付宝一样多次发送异步通知,知道用户反馈“收到了”。 当异步回调失败或者丢包(服务器问题)时,这个支付是否算是已完成?

5个月前 评论
fatrbaby 5个月前
franktrue (作者) 5个月前

在 app 上面用PayPal ,这个可以使用吗?

5个月前 评论
Double-Jin (楼主) 5个月前

打印的 支付异步回调结果 ,怎么是 pending ?

file

5个月前 评论
chauncyy 4个月前

感谢楼主分享, 不知道楼主有没有对接PayPal的订阅支付, 订阅支付的回调有四个(billing.plan.created & billing.plan.updated & billing.subscription.created & payment.sale.completed), 想问问楼主是通过哪个回调来更改本地订单状态的. 以及后续循环扣款的回调问题.

4个月前 评论
Double-Jin (楼主) 4个月前

请勿发布不友善或者负能量的内容。与人为善,比聪明更重要!