项目常见问题解决方案

项目常见问题解决方案

project-mulla Talk to MPESA API via a REST API. Bringing the MPESA G2 API to the 21st century. -- 项目地址: https://gitcode.com/gh_mirrors/pr/project-mulla

1. 项目基础介绍和主要编程语言

项目名称： Project Mulla
项目介绍： Project Mulla 是一个将 Safaricom MPESA G2 API 接口转换为 RESTful API 的中间件项目。它允许开发者通过 HTTP REST 请求与 MPESA API 通信，而无需直接处理复杂的 SOAP/XML 请求。Project Mulla 处理所有的 SOAP 交互，将响应转换为 JSON 格式，使得开发者可以更轻松地集成和使用 MPESA 服务。

主要编程语言： JavaScript

2. 新手常见问题及解决步骤

问题一：如何配置项目环境？

问题描述： 新手在使用 Project Mulla 时，可能会遇到不知道如何配置项目环境的问题。

解决步骤：

1. 克隆项目到本地：

   git clone https://github.com/kn9ts/project-mulla.git
   

2. 进入项目目录：

   cd project-mulla
   

3. 安装项目依赖：

   npm install
   

4. 配置环境变量，如 API Key 和其他必要的配置项，通常在 .env 文件中设置。

问题二：如何发起支付请求？

问题描述： 新手可能不清楚如何使用 Project Mulla 发起支付请求。

解决步骤：

1. 确保已经正确配置了环境变量，包括必要的 API Key。
2. 使用 POST 请求向 /api/v1/payment/request 端点发送支付请求。请求体中应包含以下参数：
   • phoneNumber：客户的电话号码。
   • totalAmount：要收取的总金额。
   • referenceID（可选）：订单或服务的参考 ID。
   • merchantTransactionID（可选）：特定订单或服务的交易 ID。 示例请求：

   {
     "phoneNumber": "254700000000",
     "totalAmount": 100,
     "referenceID": "order1234",
     "merchantTransactionID": "tx1234"
   }
   

问题三：如何处理支付确认？

问题描述： 新手可能不清楚如何在支付请求后处理确认。

解决步骤：

1. Project Mulla 在 /payment/request 端点初始化支付请求时，会自动调用 /payment/confirm 端点以确认支付。
2. 因此，开发者不需要额外发送确认请求。只需确保 /payment/confirm 端点在 Project Mulla 中正确配置即可。
3. 如果需要手动处理确认，可以发送一个 POST 请求到 /api/v1/payment/confirm 端点，并传入相应的参数进行确认。

project-mulla Talk to MPESA API via a REST API. Bringing the MPESA G2 API to the 21st century. -- 项目地址: https://gitcode.com/gh_mirrors/pr/project-mulla