Fecshop 支付

对支付平台的配置信息。

Fecshop-2.x更新说明

2版本更新为后台配置

xx

xx

xx

Fecshop-1.x

Payment支付配置文件

Payment支付配置文件:@common/config/fecshop_local_services/Payment.php

详细的代码可以参看:https://github.com/fecshop/yii2_fecshop_app_advanced/blob/master/common/config/fecshop_local_services/Payment.php

设置https方式

参看文章:以https方式的paypal支付

设置paypal支付

注意:paypal支付部分一定要看完文档

1.配置

因为paypal有两种,购物车点击支付按钮的快捷支付,和标准支付,因此 在两个地方进行设置

'paypal_standard' => [
    // 订单生成后,跳转到支付开始页面的url
    'start_url'            => '@homeUrl/payment/paypal/standard/start',
    // 下面是沙盒地址,线上地址为:https://api-3t.paypal.com/nvp,
    // 这个url的作用用于 Yii::$service->payment->paypal->PPHttpPost5 ,发起一些api请求
    // 譬如获取token,获取paypal存储的address(购物车快捷支付),发起扣款请求
    'nvp_url'  => 'https://api-3t.sandbox.paypal.com/nvp',
    // 下面是沙盒地址,线上地址为:https://www.paypal.com/cgi-bin/webscr
    // 获取token后,通过这个url跳转到paypal的url地址,另外paypal的IPN消息的合法性认证,也是使用的这个url
    // 也就是  Yii::$service->payment->paypal->getVerifyUrl()
    'webscr_url'  => 'https://www.sandbox.paypal.com/cgi-bin/webscr',
    'account'  => 'zqy234api1-facilitator_api1.126.com',
    'password' => 'HF4TNTTXUD6YQREH',
    'signature'=> 'An5ns1Kso7MWUdW4ErQKJJJ4qi4-ANB-xrkMmTHpTszFaUx2v4EHqknV',
    'label'=> 'PayPal Express Payments',
    // 跳转到paypal确认后,跳转到fecshop的url
    'return_url' => '@homeUrl/payment/paypal/standard/review',
    // 取消支付后,返回fecshop的url
    'cancel_url' => '@homeUrl/payment/paypal/standard/cancel',
    // 支付成功后,fecshop跳转的url
    'success_redirect_url'    => '@homeUrl/payment/success',
    // paypal发送IPN,fecshop用于接收IPN消息的地址。
    'ipn_url' => '@homeUrl/payment/paypal/standard/ipn',
],

'paypal_express' => [
    // 下面是沙盒地址,线上地址为:https://api-3t.paypal.com/nvp,
    // 这个url的作用用于 Yii::$service->payment->paypal->PPHttpPost5 ,发起一些api请求
    // 譬如获取token,获取paypal存储的address(购物车快捷支付),发起扣款请求
    'nvp_url'  => 'https://api-3t.sandbox.paypal.com/nvp',
    // 下面是沙盒地址,线上地址为:https://www.paypal.com/cgi-bin/webscr
    // 获取token后,通过这个url跳转到paypal的url地址,另外paypal的IPN消息的合法性认证,也是使用的这个url
    // 也就是  Yii::$service->payment->paypal->getVerifyUrl()
    'webscr_url'  => 'https://www.sandbox.paypal.com/cgi-bin/webscr',
    'account'  => 'zqy234api1-facilitator_api1.126.com',
    'password' => 'HF4TNTTXUD6YQREH',
    'signature'=> 'An5ns1Kso7MWUdW4ErQKJJJ4qi4-ANB-xrkMmTHpTszFaUx2v4EHqknV',
    'label'=> 'PayPal Express Payments',
    // 跳转到paypal确认后,跳转到fecshop的url
    'return_url' => '@homeUrl/payment/paypal/express/review',
    // 取消支付后,返回fecshop的url
    'cancel_url' => '@homeUrl/payment/paypal/express/cancel',
    // 支付成功后,fecshop跳转的url
    'success_redirect_url'    => '@homeUrl/payment/success',
    // paypal发送IPN,fecshop用于接收IPN消息的地址。
    'ipn_url' => '@homeUrl/payment/paypal/express/ipn',
],

更改线上地址:您需要将上面的nvp_url 和api_url的url中的sanbox去掉,,譬如 'nvp_url' => 'https://api-3t.sandbox.paypal.com/nvp', 改成 'nvp_url' => 'https://api-3t.paypal.com/nvp',

更改线上的账户:在paypal账户获取 account password signature ,注意 account password 是您的paypal的api申请到的,而不是登录paypal官网的账户密码, 具体的申请步骤参看文章: http://www.fecshop.com/topic/374 ,申请到了填写上去即可,注意上面配置里面的paypal_expresspaypal_standard 都要填写

2.登录paypal,开启IPN

一定要登录paypal官网 www.paypal.com,设置开启IPN,否则将无法接收paypal的IPN消息。

一定要登录paypal官网 www.paypal.com,设置开启IPN,否则将无法接收paypal的IPN消息。

一定要登录paypal官网 www.paypal.com,设置开启IPN,否则将无法接收paypal的IPN消息。

一定要登录paypal官网 www.paypal.com,设置开启IPN,否则将无法接收paypal的IPN消息。

重要的事情说三遍,下面是详细的设置步骤。

设置完成后,就可以接收IPN消息了。

为什么要设置接收IPN呢?可以参看一下这个文章:http://www.fecshop.com/topic/457

设置微信支付

因为微信库包sdk的配置是const常量,因此比较纠结,最后 把配置文件放到了 @common/config/payment/wxpay/lib/WxPay.Config.php文件中 ,更改里面的配置即可。

目前微信支付只支持pc端,也就是appfront端, 因为微信内部打开的网站需要公众号支付,我没有这个玩意(微信比较恶心, 没有沙盒环境,所以我没法做), 微信外部的浏览器打开的网站支付,需要用html5支付的方式, 这种支付方式又很难申请,另外,这两种支付不相通, 公众号支付无法在外部浏览器使用,html5支付无法在微信内部打开的网页使用, 很无语。

支付宝支付

@common/config/fecshop_local_services/Payment.php

'alipay' => [
    // 沙盒环境在:https://openhome.alipay.com/platform/appDaily.htm 这里获取。
    // 沙盒环境 - 商家appId 在这里获取 https://openhome.alipay.com/platform/appDaily.htm?tab=info
    'appId'         => '2016080500172713',
    // 沙盒环境 - 商家UID : https://openhome.alipay.com/platform/appDaily.htm?tab=account
    'sellerId'      => '2088102170055546',
    // 应用私钥,可以在这里通过工具生成:https://docs.open.alipay.com/291/105971/
    'rsaPrivateKey' => 'MIIEpAIBAAKCAQEApIw+Hsk65Z+mieDsEiTkhtf7ZNBgks83DLUDb1yh2d/HDB0s9zHFzsgQGny0kUTM0fJ43h7WydyUG9Kuv4fxD5iVfM2xkUYW5bvfTXVaj5LLj8rTKL+nnFybzzM5rewqh2u1Gzd7BbpOnhMn4Y+7JyyaWXsnRFBxIrmRAqQJVlVUG4RclLHfplFkMVcEMzoRda2UV54oQDMg8ZxignCqxgIKr7bpwpgdpdqZArHtmyEjhQfIblCLDjVk0rKxGsaz+ATYVt3eQozdyNEuKFRhy0VGmwmdQYhQFbge7SS6bVqXZHsq2fNZ6hMJ2XNOZajFm5jXMksnaX85PzdJ58HFewIDAQABAoIBAAn/c27Pb0Kwdp/+CJn5n+EJkn7HonaJHKErBnBnwnXIgQGdbDQA1DICOehCF36UHZXME8f7O7W8L0uZe4Crs9vsu3h/zwAysAV5atH8BWqf0rqD6lyZeIepoNXwGNsWdGcSBkkHD/SDI2+7Xjr4TrjMnvw83V/rO1SOzd7JNMAICj6NZ2tteIqQCn+BriEEawRDimSAWvVaCbwnbCDF8y40MxZ4K6picBQ0gsbC6eQuXRqzB6CoFBkQsXGtK0VXvlJXVmKRzRqPxjD6Cer21tF1CDryVedSWKsdwEXvOdO8LdPZpnmQMvwyTuhM0V9L3rif4spIK9ML3lZLzM47rpECgYEA2XzyRUEni4jKmWcE3oSZjCvp5BJwi6DSRkAphGTwoW/8oTCJhx1B43Qusxv0bUwGzN/KlRHwgNRerQ9xqWMYnIIfBJLOqASunB8eHMBDN+zC6TnUKOu43CpZ+fGVVm2VUbWLHr5h93AOBSQhtvvegbEk9hbNRCCbcY6jbZZmgkUCgYEAwa9v5Bk8q0obGonDUd5LZkHBt7mfT12cUPkfBClz8/tpv7rirCg5I4XaQHerEo+iCOpn3iIl37ix6V7LcspjJuJwpTn0OzugO7MzEyRi0zAqkNAB1voeJL/hl08rHVkA9fZ2AVuOhUvG2A1pqB8BjY9AW1/2W/EXH16qCKzfhL8CgYEAjK/QoJAHHrH8LMOBWNf547y8bfanqwr7OspikOwi5Ktmhna5YBfC+Xm8g8w/jzww4fKaP1f9dbjrDZQB+IrL7uIVYoX8/J8avI88kWilktWrN+daoKXrTTBwR8jIy8HTZ6nCNr787G0mBJlc3duMEeUffbk+SyW0p/6XJVq3MOkCgYEAhXqPJOZTjkRS63YXels1ITKd+yzcYojDynX07xxWQcV4+l4kCrrprdZ4M8eEyRTdeUF59XcZHNYfHhJrKR/bNxgEw4luDEgqRBpaT43a4WonW4dOTUYv8eme4XT45I/K/rcsWgEr9ibj0U9lCizcGB+qHY7DrFc5NTA7BCGHJOcCgYAN82UigyX4qyqpQDofP/fQOybE2QJuG4pG3x3k/nMxCYm6DAcDS9WyRIAlNwOLXDFLICPa3SlaFjC4A0hLh1CU0465Bau+/q8Avs2/Hz1SMoeqyKf8Sq3RyCFFSb0Zsq26Tr8BtyRjHfFRDiZe5O9H7lOCGqiQEgUuAE9aCgCYVA==',
    // 支付宝公钥,注意,这里不是应用私钥,需要把应用公钥提交后获取的支付宝公钥
    // 对于沙盒账户的步骤可以参看:http://blog.csdn.net/terry_water/article/details/75258175
    'alipayrsaPublicKey' => 'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAt5egD1BQCK5fCQXKsgWh+VFj9zanV9cdwVmM/MOQ/zrwMBHMIRO0IdJMft351iXtyACKVX+noK1qzkiVOdg3MxLjbGoMDKR+/1PDxoxtWSVUJBywoYHH/Dh7TCi5GWGasOlXV4qWi0e5Yfa2x/Wi0cxqx76aY5izXEyabHAvWgTWNv121ZRNhl4qcuoWZYiMIQpTst6hEhRn/isUMgdtLRQ1a06q+qOkLmJ99vq8cqbfduAdOuhzbZNWqLV76CSc0meurlVtDoIn5kVAZdzjNTA2rlqSCgs/OZxaL8s/qrIynhLoB6U6i0fj4RsIsbrvoSnrPWo98rsM0RrlU8fpdwIDAQAB',  //'MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApIw+Hsk65Z+mieDsEiTkhtf7ZNBgks83DLUDb1yh2d/HDB0s9zHFzsgQGny0kUTM0fJ43h7WydyUG9Kuv4fxD5iVfM2xkUYW5bvfTXVaj5LLj8rTKL+nnFybzzM5rewqh2u1Gzd7BbpOnhMn4Y+7JyyaWXsnRFBxIrmRAqQJVlVUG4RclLHfplFkMVcEMzoRda2UV54oQDMg8ZxignCqxgIKr7bpwpgdpdqZArHtmyEjhQfIblCLDjVk0rKxGsaz+ATYVt3eQozdyNEuKFRhy0VGmwmdQYhQFbge7SS6bVqXZHsq2fNZ6hMJ2XNOZajFm5jXMksnaX85PzdJ58HFewIDAQAB',
    // 下面是沙盒地址, 正式环境请改为:https://openapi.alipay.com/gateway.do
    'gatewayUrl'    => 'https://openapi.alipaydev.com/gateway.do', 
],

设置上面的相应信息即可。每一行都有注释,详细看即可。

开发新支付 - 配置

当您想要开发一个新的支付方式的时候,您需要做一个跳转到第三方支付平台的准备页面(payment start url) 和一个支付成功返回的页面url。

下面是详细的步骤,我这里也有一个支付宝开发的详细步骤,供参考,地址为:http://www.fecshop.com/topic/143

1.1 支付跳转前的工作

xxx

在支付页面,填写好支付信息后,点击支付按钮,fecshop会先进行一系列的处理, 最终生成订单,将订单编号保存到session中,然后跳转到当前支付配置对应的 start_url,譬如上面paypal的start_url@homeUrl/payment/paypal/standard/start (@homeUrl是首页url),在这个url中,需要将订单中的字段值取出,组合成支付平台想要的 数据格式,发送给第三方支付平台,并进行跳转到第三方支付平台。

1.2 支付成功跳转后的工作

支付成功后,用户通过点击,或者由第三方支付平台自动,跳转到网站中,也就是上面配置的 success_redirect_url,该url对应的内容显示用户支付成功后的信息

1.3 在第三方支付平台取消订单

如果用户在支付平台点击取消订单,那么就会跳转到fecshop的取消订单的链接, 也就是cancel_url对应的链接

1.4 IPN消息url

当用户支付成功后,支付平台会给fecshop发送一个支付成功的消息,fecshop接收到消息 后会把接收到的参数传递给paypal并进行询问是否是paypal发送的,当paypal反馈是, fecshop会把订单支付状态改成processing

开发新支付 - 功能实现

上面填写的4个url,您可以扩展一个新模块实现url对应的功能即可。 二开支付,知道原理后,还是蛮容易的。

paypal支付详细说明:

paypal有两种支付方式,一种是购物车页面点击支付按钮的方式,一种是 填写完成货运地址等信息后,在支付的方式。

paypal 购物车按钮流程

1.购物车点击paypal支付按钮,进入start部分:

1.1 检查产品库存,如果库存不足,则返回购物车页面

1.2 生成订单,订单只有order_id,increment_id,payment_token几个字段填写值,其他为空

1.2 获取token,跳转到paypal express部分

2.进入paypal网站,确认后返回网站

2.1 用户登录后点击continue,跳回网站return url,在该页面api获取用户paypal保存的货运地址,自动填写货运地址

3.提交

3.1 用户修改货运地址等编辑信息。

3.2 用户点击提交按钮,发起支付请求。

3.3 服务器端检验用户提交的货运地址等信息是否正确

3.4 如果用户使用的是新地址,则插入用户的货运地址。

3.5 生成订单,不清空购物车,但是扣除库存。(生成订单的时候,是通过1.1token进行查询出来的,而不是new的新的)


3.6 如果api请求发生报错,那么返回到return页面(譬如货运地址填写错误等),显示报错信息,让用户重新编辑信息提交,重新发起支付请求。

3.7 如果发生报错多次,token就会失效,paypal会拒绝请求。返回一个token超出最大使用次数。

3.8 api发起支付请求,支付成功后,把支付信息写入到订单中,清空购物车。	

3.9 最后跳转到支付成功页面。支付成功页面一般加入以下监控的js,接收支付成功信息。

注意:ipn部分目前没有做任何处理,只是打印了一下log, 如果用户在paypal提出申诉,要求退款等,paypal会给网站发送一个消息, 网站这边不会同步订单状态为“取消”,而是让erp那边做处理。

paypal 填写货运地址在点击支付的流程。

  1. 填写表单:

    1.1 用户在购物车页面填写地址信息,货运方式,支付方式

    1.2 用户提交

    1.3 服务端接收信息生成订单,生成订单扣除产品库存,但是不清空购物车,

    然后根据配置的startUrl,跳转到相应的链接
    
    

    1.4 生成订单的时候,如果存在错误,跳转到checkout/onepage页面,显示报错信息

  2. Start部分:

    2.1 提交相应订单信息获取token

    2.2 更新token到订单中

    2.3 跳转到paypal支付网站,登录后,点击pay now返回网站(购物车点击过去,显示的按钮是continue)

  3. return部分:

    3.1 通过返回的token,查询订单,得到订单信息

    3.2 根据订单信息,拼装成api url,api发送下单请求。

    3.3 如果下单失败,跳转到checkout/onepage页面,显示报错信息

    3.4 如果下单成功,清空购物车

    3.5 跳转到支付成功页面。

如果您想开发一个新支付,可以参考下支付宝支付的整个步骤: Fecshop 支付宝支付开发思路 和 详细的文件结构
,这个文章写得比较详细,可以了解整个流程。