README

Laravel 项目用于 Tanda 支付 API

此包帮助您将 Tanda 支付 API 集成到您的 Laravel 应用中。

以下 API 可以通过此包集成

• 空中充值
• 公用事业账单支付
• 空中充值券购买
• 电视订阅
• 交易状态
• 账户余额

此包基于 Tanda 的 REST API，可以在以下位置找到：https://docs.tanda.co.ke/reference

安装

您可以通过 composer 安装此包

composer require alvoo/tanda

配置

安装包后，运行；

php artisan tanda:install

或

php artisan vendor:publish

这将发布 config/tanda.php 文件。此文件是您添加 Tanda API 配置的地方。默认情况下，配置设置为 sandbox，如果您使用的是实时凭据，请更新为 'live'。

在您的应用的 .env 中添加您的 Tanda 凭据如下

TANDA_CLIENT_ID=[Client ID]
TANDA_CLIENT_SECRET=[Client Secret]
TANDA_ORG_ID=[Organization ID]
TANDA_ENV=[sandbox or live]

回调 URL 必须 在 config/tanda.php 中更新。
更新您的 .env 后，更新配置

php artisan config:cache

使用方法

导入 Tanda Facade

use Tanda;

空中充值（免密预付费空中充值）

您可以使用此 API 进行直接空中充值。
接受的参数

1. Provider - 服务提供商 ID SAFARICOM、AIRTEL、TELKOM。
2. MSISDN - 国际格式电话号码。
3. Amount - 充值金额（应在 10 到 10000 之间）。

$topup = Tanda::pinlessAirtime("SAFARICOM", "254712345678", 100);

电视支付

此方法用于支付电视订阅。
接受的参数

1. Provider - 电视服务提供商（GOTV、DSTV、ZUKU、STARTIMES）。
2. Account - 一个有效的盒子账户号码。
3. Amount - 账单金额（应在 10 到 20000 之间）。

$pay = Tanda::payTV("GOTV", 201712256, 100);

账单支付

使用此方法进行账单支付。
接受的参数

1. Provider - 内罗毕水（NAIROBI_WTR）。
2. Account - 内罗毕水表号码。
3. Amount - 账单价值（应在 100 到 35000 肯尼亚先令之间）。

$bill = Tanda::billPay("NAIROBI_WTR", 25419321, 100);

空中充值券

此方法用于生成空中充值券 PIN，您可以使用它像刮卡一样进行充值。
接受的参数

1. Provider - 服务提供商 ID（SAFARICOM、TELKOM、AIRTEL）。
2. Amount - 优惠券价值。
   • Airtel - 20、50、100、250、500、1000。
   • Safaricom - 20、50、100、250、500、1000。
   • Telkom - 20、50、100、200、500、1000。

$voucher = Tanda::voucherFix("SAFARICOM", 254712345678, 100);

余额

此方法用于查询 API 的账户余额。

$balances = Tanda::balances();

交易状态

使用此方法查询交易状态 API。
接受的参数

1. Transaction ID - 初始化阶段返回的唯一请求 ID。

$status = Tanda::query("ee92d1cb-625c-4e0a-8f28-8e86d929f9d7");

贡献

欢迎提交拉取请求和问题。请参阅 CONTRIBUTING.md

安全漏洞

如果您发现任何安全漏洞，请发送电子邮件到 alvinmayende@gmail.com。

许可证

此包是开源软件，在 MIT 许可证 下授权。