wfpay/pjbank

用于与PJBank API进行通信的库

dev-master 2024-03-01 16:25 UTC

This package is auto-updated.

Last update: 2024-09-30 17:52:33 UTC


README

信用卡集成应无中间商介入,即当最终客户支付账单时,金额应直接在释放金额后存入我方客户账户。

因此,我们需要通过将我们的代理与他们的注册信息绑定来认证将使用wfpay的客户。

PJBank API文档:访问文档

如何使用

收款流程如下

  1. 我们通过PJBank提供的库对客户的信用卡号进行令牌化。
  2. 通过信用卡令牌化,我们通过信用卡令牌验证路由插入其他数据。
  3. 数据验证后,我们通过带有信用卡令牌的收款创建路由创建收款。
  4. 创建收款后,我们通过收款查询路由查询收款。

重要提示: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方法查询客户,传递客户的credencialchave到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');