semernur / chapa
Laravel Chapa支付网关包
Requires
- php: ^7.4|^8.0
- guzzlehttp/guzzle: ^7.4.5
- illuminate/support: *
This package is auto-updated.
Last update: 2024-09-16 09:29:46 UTC
README
Laravel的Chapa包
Chapa是埃塞俄比亚的一个支付网关。这个Laravel包可以帮助您将Chapa集成到下一个或现有的Laravel项目中。通过以下方式安装:composer require semernur/chapa
这个包包含一些功能,可以帮助您轻松初始化支付,验证支付,并且很快还会添加其他功能。
文档
在开始使用这个包之前,您需要拥有Chapa API密钥,您可以从以下地方获得一个:一旦您获得了API密钥,请将其秘密密钥添加到.env文件中,或者您可以直接将其传递给构造函数。如果您使用的是通过.env文件访问的方法,则变量名称应为CHAPA_SECRET_KEY
。安装成功后,您需要运行php artisan migrate
来设置包的数据库表。
可用方法
initializePayment(array $details, bool $will_redirect = FALSE, string $custom_ref = NULL)
$details,您需要在Chapa的API中初始化的详细信息。您不需要传递授权令牌! $will_redirect,如果设置为true,则在支付初始化成功后自动将客户重定向到checkout_url。
$custom_ref如果不为NULL,则initializePayment
将使用$custom_ref作为chapa的tx_ref
字段。
如果$custom_ref未定义且$ref_prefix已定义,则initializePayment
将使用带有前缀$ref_prefix
的唯一tx_ref。 注意: initializePayment
将返回Chapa的响应/对象,无论您是否将$will_redirect
设置为TRUE或FALSE。
verifyPayment(string $tx_ref, bool $only_status = FALSE)
此方法将验证支付,需要$tx_ref
交易参考来验证所需交易。如果$only_status
设置为true,则仅返回交易状态。如果交易状态为成功,则返回TRUE,否则返回false。