semernur/chapa

Laravel Chapa支付网关包

1.1 2023-03-18 15:54 UTC

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密钥,您可以从以下地方获得一个:

Chapa

一旦您获得了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。

享受吧!