README

v 2.1.2

此插件简化了基于 CakePHP 2.x 开发的应用程序中通过 PagSeguro 进行支付集成的过程。插件仅负责与 PagSeguro 支付 API 进行接口交互，因此插件和 PagSeguro 都不对不符合 PagSeguro 提供的文档的使用承担责任 https://pagseguro.uol.com.br/v2/guia-de-integracao/visao-geral.html 以及提供的值。向 PagSeguro 提供正确信息的责任完全由创建购物车关闭请求的开发者承担。

安装

Composer

composer require andrebian/pag_seguro

{
    "require": {
        "andrebian/pag_seguro": "dev-master"
    }
}

或选择特定版本

{
    "require": {
        "andrebian/pag_seguro": "2.0.0"
    }
}

等等

{
    "require": {
        "andrebian/pag_seguro": "*"
    }
}

常见错误

由于依赖于 PagSeguro 的开发版本，可能需要标记要安装的包的最小稳定性。

{
    "require": {
        "andrebian/pag_seguro": "*"
    },
    "minimum-stability": "dev"
}

非常重要

默认情况下，CakePHP 2.x 在 app/Plugin/ 内使用插件，但通过 composer 直接安装时，它将被安装在其应用的根目录（Plugin/）而不是 app/Plugin/。为此，有两种解决方案：第一种是通过 composer.json 文件直接定义，第二种是通知新的插件访问点。以下将分别描述。

选项 1 - 通过 composer.json 定义

在其 composer.json 文件中，请输入以下内容

"extra": {
    "installer-paths": {
        "app/Plugin/PagSeguro": ["andrebian/pag_seguro"]
    }
}

选项 2 - 在 bootstrap.php 中通知

可以在 bootstrap.php 中通知一个新的插件访问点，这样 Cake 2.x 将会在以下位置搜索插件：Plugin/ 和 app/Plugin/。

App::build(array('Plugin' => array(ROOT . '/Plugin/', ROOT . '/app/Plugin/')));

选择此选项后，第一种方法可以忽略。

有关这些选项的更多信息，请参阅我的博客上的这篇文章，并在文章末尾查看 @markstory、@ADmad 和 @ceeram 解释 Cake 和结构以及建议使用 bootstrap.php 的 issue： http://www.andrebian.com/cakephp-e-composer/

注意

不再提供直接下载或作为子模块使用的支持。由于依赖于 PagSeguro 的官方 API，必须通过 composer 正确安装。如果想要这样做（clone、zip 或子模块），可以这样做，但不会提供支持，因为满足所有依赖的唯一方式是上面提到的。

配置

加载插件

在 bootstrap.php 文件中添加对插件的支持：CakePlugin::load('PagSeguro'); 或 CakePlugin::loadAll();

凭证

您必须在 PagSeguro 上拥有账户，因为需要设置凭证，这些凭证由您的电子邮件地址和 PagSeguro 集成部分设置的 token 组成。

此配置可以通过两种方式完成：通过 bootstrap 或在所需的控制器中。

bootstrap 文件

Configure::write('PagSeguro', array(
    'email' => 'seu-email-cadastrado@pagseguro',
    'token' => 'seu-token',
    'isSandbox' => true, // true|false
));

控制器任意位置将安装购买完成

$this->Checkout->defineCredenciais('email cadastrado', 'token gerado');

加载组件

您已经设置了凭证后，应在 AppController 或将要使用组件的控制器中设置

public $components = array('PagSeguro.PagSeguro', 'PagSeguro.Checkout', 'PagSeguro.RetornoPagSeguro');

如果您已有更多组件，请按以下方式操作

public $components = array('Outros componentes', 'PagSeguro.PagSeguro', 'PagSeguro.Checkout', 'PagSeguro.RetornoPagSeguro');

请勿忽略对 'PagSeguro.PagSeguro' 的使用。

使用

支付请求：请阅读文件 REQUISICAO_PAGAMENTO
支付请求返回：请阅读文件 CONSULTA
按代码查询：请阅读文件 CONSULTA
按时间段查询：请阅读文件 CONSULTA
按取消交易查询：请阅读文件 CONSULTA
通知：请阅读文件 NOTIFICACAO

待办事项

测试

问题

请在此处报告 https://github.com/andrebian/cake-plugin-pagseguro/issues?state=open

贡献者

Marcelo Siqueira - https://github.com/marcelosiqueira

注意

许多开发者在示例中使用了我的个人电子邮件进行购买，我恳请您在测试购买时请使用您自己的电子邮件，我已经帮助过插件，无法帮助检查电子邮件和提供报告。

非常感谢。

andrebian / pag_seguro

维护者

详细信息