dagim / telebirr-api
简化Telebirr支付网关集成到Laravel应用中的过程。轻松生成支付URL、处理通知并确保安全交易。凭借强大的错误处理和配置灵活性,简化Telebirr支付集成到您的Laravel项目中。
dev-main
2024-05-05 07:08 UTC
Requires
- laravel/framework: >=8.0
This package is not auto-updated.
Last update: 2024-09-23 07:21:36 UTC
README
项目描述
Telebirr Laravel集成包是一个用于将Telebirr H5 Web支付功能集成到Laravel应用中的Laravel助手包。此包通过Web实现支付,允许第三方系统在客户发起支付请求时调用接口。支付完成后,从Telebirr平台返回一个重定向页面给第三方系统。
逻辑规格说明
平台认证规则
- Telebirr平台为相应的第三方客户端分配appId和appKey,以唯一标识它们。
- 必须将第三方源IP地址添加到信任列表中。不在信任列表中的IP地址无法访问Telebirr系统。
- 时间戳必须与服务器时间一致(在一分钟内)。不一致的访问被视为非法。
- 客户端输入的签名必须与系统生成的签名匹配。不一致的访问被视为非法。
接口描述
响应消息元素
入门指南
安装Telebirr Laravel集成包
composer require dagim/telebirr-api:dev-main
使用示例
use Dagim\TelebirrApi\Telebirr; $telebirr = new Telebirr( env('TELEBIRR_APP_ID'), env('TELEBIRR_APP_KEY'), env('TELEBIRR_PUBLIC_KEY'), env('TELEBIRR_PRIVATE_KEY'), env('TELEBIRR_API_URL'), env('TELEBIRR_SHORT_CODE'), env('TELEBIRR_NOTIFY_URL'), env('TELEBIRR_RETURN_URL'), env('TELEBIRR_TIMEOUT_EXPRESS'), env('TELEBIRR_RECEIVE_NAME') ); $title = 'Product Purchase'; $amount = 100.00; $orderResult = $telebirr->createOrder($title, $amount); if ($orderResult['success']) { // Payment creation successful $paymentId = $orderResult['payment_id']; } else { // Payment creation failed $errorMessage = $orderResult['message']; }