README

随着Pix的推出，许多实体店开始适应这种新的支付方式。但仍然存在一个问题：生成Pix很复杂。例如，一些客户需要多个不同的员工生成Pix，但显然，他们中并不是所有人都能访问银行应用程序来生成Pix。

这个项目就是为了解决这个问题而诞生的。它是一个微型界面，可以生成QR Code格式的Pix代码和Pix Copia & Cola格式的代码。看看它是如何工作的

如果您喜欢这个应用程序的功能并想支持这项工作，请随意为随机的Pix密钥 aae2196f-5f93-46e4-89e6-73bf4138427b 做任何捐赠 ❤。

关于应用

用户从 https://pix.empresa.com.br 域名打开平台并输入用户名/密码；
然后被导向一个界面，选择Pix账户并填写数据，如：购买金额、交易ID和描述；
点击“生成Pix”按钮后，一个新的界面会显示可以由其他设备扫描的 QR Code 或可以在线共享的 Pix Copia & Cola。

不错吧？这里的目的是简单。因此，我们没有使用可用的框架或数据库。用户和Pix账户分别存储在 /app/config/users.php 和 /app/config/accounts.php 中。

何时应该使用它？

如果您想简单、容易、快速地生成Pix代码；
您希望第三方为您生成Pix代码；
您不想总是进入银行应用程序（进行无聊的过程）来生成新的Pix；
如果您想在没有第三方平台/api付费的情况下生成Pix；
如果您想以简单、方便、快捷的方式开始使用Pix进行销售。

最低要求是什么？

您需要一个Web服务器，如 Apache 或 Nginx。PHP 7.4或更高版本。

我不知道如何安装/配置，我该怎么办？

通过电子邮件 dev@piggly.com.br 联系我们，我们将尽力帮助您实施此应用程序。

应用程序用户

我们应用程序存在用户的原因只有一个： 预防故意访问。应用程序的信息不敏感。它们非常简单，仅用于生成Pix代码。因此，登录和用户系统非常简单。仅有一个包含用户/密码列表的 array。

应用程序的Pix账户

也代表一个包含所有已注册账户的 array，在生成Pix代码时可以从中选择。没什么大不了的，而且，再次强调，这些信息不敏感，因此不必担心。

如何提高安全性？

在这种情况下，建议您在应用程序中创建自己的Pix账户，使用随机密钥。这样，您就不会暴露任何敏感数据，如：电子邮件、电话、CPF或CNPJ。

关于Pix

Pix 是由 巴西中央银行 创造的最新电子支付方式。您可以在Pix的官方页面找到所有详细信息。

为了在该应用程序中实现它，我们使用了我们自己的库 piggly-dev/php-pix。如果您在使用Pix密钥时遇到问题，比如

无效的QR码；
无效的Pix复制粘贴。

我们建议您在我们的pix库中创建一个issue，点击这里（记住在创建issue时遵循说明）。这样我们可以更好地组织每个功能的职能。

安装

该应用程序可以通过以下命令使用Composer创建：composer create-project piggly/php-pix-app pix。

如果您愿意，您也可以使用以下命令克隆此存储库：git clone https://github.com/piggly-dev/php-pix-app.git，或者通过点击这里下载最新版本。

图形化安装

为了简化该应用程序的配置，我们启用了一些帮助您配置的应用程序命令。为此，您需要访问您的机器的terminal。未来我们将实现一个界面来进行这些配置，但目前这已经足够了。

进入应用程序的根目录，并执行命令php bin/console app:install。只需遵循屏幕上的所有说明即可。以下是所有可用命令的列表

php bin/console app:install 执行应用程序的所有初始配置。
php bin/console user:change 修改用户密码。
php bin/console user:create 创建新用户。
php bin/console user:delete 删除用户。
php bin/console user:list 列出所有用户。
php bin/console account:create 创建新的Pix账户。
php bin/console account:delete 删除Pix账户。
php bin/console account:list 列出所有Pix账户。

手动安装

如果您愿意或没有访问到机器的terminal，您也可以手动进行配置。首先转到/app目录并打开文件.env。在此文件中，配置以下变量

DOMAIN 写入包括http(s)的域名。例如：https://pix.piggly.lab;
HTTPS 如果使用https则写入true，否则写入false；
SITE_NAME 写入（用引号括起来）应用程序的名称。例如："Pix por Piggly";
SESSION_NAME 写入（没有空格）应用程序会话的名称。例如：pix_piggly_lab;
SECRET_KEY 创建一个32个字符或更长的随机密钥并将其放在这里。例如："XnPvo6Wu3RAAP6i72poT0FH0pIXjWwCwOSA9Taenbs4=";
BOOTSTRAP_CDN 如果想使用Bootstrap的CDN则写入true，如果不使用则写入false。我们建议在内部访问（在企业内部）时使用false，因为它们可能会阻止未知域名，外部CSS不会工作；如果不适用，请使用true，缓存策略会更有效。

然后，是时候在文件/app/config/users.php中配置用户了，只需遵循格式

<?php

return [ 
  [
    '_id' => '1',
    'username' => 'usuario01',
    'password' => 'senhaaleatoria',
  ],
];

最后，配置Pix账户在文件/app/config/accounts.php中，只需遵循格式

<?php

return [
  'conta-01' => 
  [
    'label' => 'Conta 01',
    'merchantName' => 'Nome do Titular',
    'merchantCity' => 'Cidade do Titular',
    'keyType' => 'Tipo da Chave',
    'key' => 'Chave',
  ],
  'conta-02' => 
  [
    'label' => 'Conta 02',
    'merchantName' => 'Nome do Titular',
    'merchantCity' => 'Cidade do Titular',
    'keyType' => 'Tipo da Chave',
    'key' => 'Chave',
  ],
];

在keyType中，重要的是要写入正确的值，好吗？请查看下表，了解哪些值是有效的

屏幕

以下是应用程序的屏幕，功能正常。

变更日志

查看CHANGELOG以获取有关代码中所有更改的信息。

贡献

在提交贡献之前，请查看CONTRIBUTING以获取信息。

安全

如果您发现任何与安全相关的问题，请通过dev@piggly.com.br发送电子邮件，而不是使用GitHub的问题跟踪器。

版权

支持此项目

Piggly Studio 是一家位于巴西里约热内卢的本地代理商。如果您喜欢这个库的功能并想支持这项工作，请随意为以下随机Pix密钥进行捐赠 aae2196f-5f93-46e4-89e6-73bf4138427b ❤。

许可证

MIT许可证（MIT）。更多信息请参阅 LICENSE。

piggly / php-pix-app

维护者

详细信息