dagim/telebirr-api

简化Telebirr支付网关集成到Laravel应用中的过程。轻松生成支付URL、处理通知并确保安全交易。凭借强大的错误处理和配置灵活性,简化Telebirr支付集成到您的Laravel项目中。

dev-main 2024-05-05 07:08 UTC

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'];
  
}