README

PAGSEGURO 插件

v 2.1.2

简化了使用 PagSeguro 进行支付集成的过程，该插件仅负责与 PagSeguro 支付 API 进行接口交互。因此，无论插件还是 PagSeguro 都不对违反 PagSeguro 提供的文档使用承担责任，包括但不限于提供的值。正确的信息提交给 PagSeguro 的责任完全由创建购物车结账请求的开发者承担。https://pagseguro.uol.com.br/v2/guia-de-integracao/visao-geral.html

安装

Composer

{
    "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/')));

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

有关这些选项的更多信息，请阅读我的博客中的这篇文章，并查看文章末尾提到的 Debug Kit 的问题，其中 @markstory、@ADmad 和 @ceeram 解释了 Cake 的原因和结构，并建议使用 bootstrap.php：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

##TODO

• 测试

##PROBLEMAS

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

##CONTRIBUIDORES

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

##注意：许多开发人员使用我在示例中使用的个人电子邮件进行购买，我恳请您，请务必使用您的电子邮件进行购买测试，我已经帮助了这个插件，我不能帮助验证电子邮件和提供报告。

非常感谢。