M Pesa (Safaricom Daraja API)

🚀 达拉亚项目

达拉亚项目致力于打造一套基于 safaricom 的 Daraja API 的工具与框架，以此简化 M-Pesa 支付解决方案的集成流程。借助该项目，开发者能够更便捷地实现各类支付功能。

🚀 快速开始

达拉亚项目提供了一系列实用功能，可助力开发者轻松集成 M-Pesa 支付解决方案，涵盖发起支付请求、生成支付二维码、查询账户余额以及实现 B2C 支付等功能。

✨ 主要特性

• stk_push：发起 M-Pesa STK 推送请求，要求客户在移动设备上授权支付。
• generate_qr_code：生成 QR 码，供客户扫描完成支付。
• account_balance：查询账户余额。
• b2c_payment：实现 B2C 支付功能。

📦 安装指南

请参考 安装文档 进行项目安装和配置。

💻 使用示例

支付工具

stk_push

发起 M-Pesa STK 推送请求，提示客户在移动设备上完成支付授权。

# 输入参数:
# - `amount` (int): 需要支付的金额
# - `phone_number` (int): 客户的电话号码
# 返回值: JSON 格式的 M-PESA API 响应

generate_qr_code

生成 QR 码，用于客户扫描完成支付。

# 输入参数:
# - `merchant_name` (str): 商家名称
# - `transaction_reference_no` (str): 交易参考号
# - `amount` (int): 总金额
# - `transaction_type` (Literal["BG", "WA", "PB", "SM", "SB"]): 交易类型
# - `credit_party_identifier` (str): 收款方标识（手机号码、企业号码、代理柜台、Paybill、商家商品）
# 返回值: JSON 格式的 M-PESA API 响应，包含 QR 码数据

支付提示语

stk_push_prompt

生成用于发起 M-Pesa STK 推送支付请求的提示语。

# 输入参数:
# - `phone_number` (str): 客户电话号码
# - `amount` (int): 支付金额
# - `purpose` (str): 支付目的
# 返回值: 格式化的 STK 推送请求提示字符串

generate_qr_code_prompt

生成用于创建 M-Pesa QR 码支付请求的提示语。

# 输入参数:
# - `merchant_name` (str): 商家名称
# - `amount` (int): 支付金额
# - `transaction_type` (str): 交易类型（BG 表示购买商品，WA 表示钱包，PB 表示 Paybill，SM 表示发送资金，SB 表示发送至企业）
# - `identifier` (str): 收款方标识（电话号码、企业号码、代理柜台、Paybill、商家商品）
# - `reference` (str, optional): 交易参考号。如果未提供，默认生成。
# 返回值: 格式化的 QR 码生成提示字符串

文档处理工具

create_source

创建一个从数据源到无结构服务器的数据连接器，用于数据处理。

# 输入参数:
# - `connector_name` (str): 数据源连接器的名称
# 返回值: 新创建的连接器对象

create_target

创建一个从无结构服务器到目标系统的数据连接器，用于数据处理。

# 输入参数:
# - `connector_name` (str): 目标连接器的名称
# - `target_system` (str): 目标系统标识
# 返回值: 新创建的连接器对象

transform

定义并应用一个数据转换规则到目标连接器。

# 输入参数:
# - `connector` (TargetConnector): 需要转换的目标连接器
# - `rule` (Dict[str, Any]): 数据转换规则
# 返回值: 应用转换后的数据结果

文档处理提示语

extract

从文档中提取指定信息。

# 输入参数:
# - `document` (str): 输入文档内容
# - `fields` (List[str]): 需要提取的字段列表
# 返回值: 提取的结果字典

classify

对文档进行分类。

# 输入参数:
# - `document` (str): 输入文档内容
# - `categories` (List[str]): 可能的分类标签
# 返回值: 分类结果和置信度分数

📚 详细文档

资源信息

项目相关资源如下：

• API 文档：API 文档链接
• 示例代码：示例代码仓库

📄 许可证

本项目遵循 MIT 协议。具体许可内容请参考 LICENSE 文件。

致谢

感谢以下机构和个人对本项目的贡献和支持：

• Safaricom：提供了强大的 M-Pesa 服务支持
• Open Source 社区：为项目的开发和维护提供了宝贵的反馈和技术支持