wfpay / pjbank
用于与PJBank API进行通信的库
Requires
- guzzlehttp/guzzle: ^6.3
This package is auto-updated.
Last update: 2024-09-30 17:52:33 UTC
README
信用卡集成应无中间商介入,即当最终客户支付账单时,金额应直接在释放金额后存入我方客户账户。
因此,我们需要通过将我们的代理与他们的注册信息绑定来认证将使用wfpay的客户。
PJBank API文档:访问文档
如何使用
收款流程如下
- 我们通过PJBank提供的库对客户的信用卡号进行令牌化。
- 通过信用卡令牌化,我们通过信用卡令牌验证路由插入其他数据。
- 数据验证后,我们通过带有信用卡令牌的收款创建路由创建收款。
- 创建收款后,我们通过收款查询路由查询收款。
重要提示:PJBank库用于信用卡令牌化和收款创建,信用卡令牌验证和收款查询是通过PJBank API直接执行的,不得保存客户信用卡的任何信息,除非PJBank提供的令牌,只有符合PCI合规的企业才能保存信用卡信息。
要使用PJBank库,首先需要在项目中安装它。执行以下命令:
composer require pjbank/pjbank-php-sdk
安装后,我们需要实例化ApiPjbank
类,并传递必要的认证参数。
$pjbank = new ApiPjbank( 'credencial', 'chave', false, // Utilizar ambiente de produção false, // Utilizar debug das requisições efetuadas );
可用方法
以下是PJBank库中可用的方法列表。
认证
客户注册
您可以使用cadastrarCliente
方法在PJBank中注册客户,该方法需要一个包含客户数据的数组,这些数据可以在文档中找到。
$pjbank->Credenciamento()->cadastrarCliente($dadosDoCliente);
客户查询
您也可以使用consultarCliente
方法查询客户,传递客户的credencial
和chave
到PJBank实例。
$pjbank->Credenciamento()->consultarCliente();
信用卡
创建收款
要创建信用卡收款,您可以使用criarCobrancaCartaoViaToken
方法,传递包含收款数据的数组,该路由使用信用卡号令牌化进行收款创建,前端执行以消除PCI合规性需求,该方法也由PJBank提供并可在文档中找到,关于创建收款时应发送的附加数据,请参阅文档。
$pjbank->CartaoCredito()->criarCobrancaCartaoViaToken($dadosDaCobranca);
查询收款
要查询信用卡收款,您可以使用consultarTransacaoViaTid
方法,传递收款的tid
。
$pjbank->CartaoCredito()->consultarTransacaoViaTid('tid');
如果创建了通过consultarTransacaoViaNumeroPedido
使用的订单号,也可以进行查询。
$pjbank->CartaoCredito()->consultarTransacaoViaNumeroPedido('pedido_numero');
取消收费
要取消信用卡收费,您可以使用 cancelarCobrancaCartao
方法,并传递收费的 tid
。
$pjbank->CartaoCredito()->cancelarCobrancaCartao('tid');