paga/paga-connect

Paga Connect 是一个为 Paga 商业客户提供无缝集成的商户库,无需要求用户始终批准交易。用户授权并批准第一次,然后后续交易将代表用户执行

v1.0.4 2020-05-30 13:42 UTC

This package is auto-updated.

Last update: 2024-09-16 09:25:35 UTC


README

由库暴露的连接服务

  • getAccessToken
  • merchantPayment
  • moneyTransfer
  • getUserDetails

关于上述服务的更多信息,请访问 Paga 开发者网站

如何使用

composer require paga/paga-connect

require_once __DIR__ .'/vendor/autoload.php'

$pagaConnect = PagaConnectClient::builder()
                    ->setPrincipal("<Paga-Client-ID>")
                    ->setCredential("<Paga-Secret-Key>")
                    ->setRedirectUri("<Your-Redirect-URL>")
                    ->setScope(array('USER_DEPOSIT_FROM_CARD','MERCHANT_PAYMENT','USER_DETAILS_REQUEST'))
                    ->setUserData(array('FIRST_NAME','LAST_NAME','USERNAME','EMAIL'))
                    ->setIsTest(true)
                    ->build();

如上图所示,您设置 Paga 提供的主键和凭证,如果将 setIsTest() 的值传递为 true,则库将使用测试 URL 作为所有调用的基本 URL。否则,将其设置为 false 将使用您 传递 的实时 URL 值作为基本 URL。

连接服务函数

商户支付

这是代表客户为您执行付款的操作。要使用此函数,请在 ConnectClient 中调用 getAccessToken,它将返回一个包含访问令牌的 JSONObject,该令牌将用于完成付款。

要获取访问令牌,请使用从后端调用获得的授权码

$token_data = $pagaConnect->getAccessToken($authorization_code);

访问令牌用于执行商户支付,如下所示

$payment_data = $pagaConnect->merchantPayment( $token_data, "ref-12345", 500, 7101, "1wxew", "NGN");

转账

此操作允许您为用户的 Paga 账户充值。要使用此函数,请在 ConnectClient 中调用 moneyTransfer,它将返回一个 JSONObject。

$result = $pagaConnect ->moneyTransfer( $token_data, "ref123", "2200", "08184361000", "yes");

获取用户详情

此操作允许客户端获取用户的个人详情。请求的数据包含在认证和授权请求的数据参数中。此外,作用域参数必须包含 USER_DETAILS_REQUEST 选项。要使用此函数,请在 ConnectClient 中调用 getUserDetails,它将返回一个包含用户详情的 JSONObject。

$result = $pagaConnect ->getUserDetails( $token_data, "ref123");