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 社區：為項目的開發和維護提供了寶貴的反饋和技術支持