labyrinthe/payment

简化多个支付聚合器支付模块集成过程的软件包

维护者

详细信息

github.com/Dr-Lab1/Labyrinthe-Payment

主页

源代码

问题

安装: 18

依赖项: 0

建议者: 0

安全性: 0

星标: 1

关注者: 1

分支: 0

开放问题: 0

1.0.0 2024-03-31 14:30 UTC

MIT e14958619408ef57748e1d934f22a70d9fe84e26

This package is auto-updated.

Last update: 2024-10-03 11:59:54 UTC

README

计划

软件包描述

在编程中，一个包（或模块，取决于语言）是一系列代码元素，如类、函数、变量和常量。它是一个关键的组织工具，使代码能够以模块化和连贯的方式组织，使其更容易阅读、维护和重用。

我们软件包的主要目的是提供便于集成各种支付聚合器（如 Labyrinthe、Flexpay、Stripe 等）的类和函数。通过使用此软件包，您无需从头开始编写逻辑，从而节省时间。在某些情况下，一行代码就足以执行复杂的函数。

安装 Labyrinthe/Payment 软件包

我们的软件包可以通过多种方式安装，包括 composer 和 github。

使用 Composer

如果您还没有安装 composer，现在是时候安装它了。毕竟，它是 PHP 依赖项的主要安装程序。 点击此处安装 composer。

安装后，转到您项目的根目录并运行以下命令

composer require labyrinthe/payment

使用 GitHub

通过 GitHub 安装，有两种方式。要么通过 git clone，要么通过下载软件包的 zip 文件。

  1. Git clone

     git clone https://github.com/Dr-Lab1/Labyrinthe-Payment

  2. 获取链接并下载

     https://github.com/Dr-Lab1/Labyrinthe-Payment

如何使用 Labyrinthe\Payment ?

全局

仅使用静态方法简化其使用，该软件包易于理解和使用。例如，要从 X 聚合器进行移动支付，调用此操作的代码将相当简单。

示例

  // array of params
  $array = [];
  $mobile_payment = AggregatorServiceProvider::mobile($array);

软件包方法和类的响应都采用相同的格式。换句话说，您不需要深入了解响应以了解其性质。

默认响应格式是 JSON。为什么是这样？因为它易于访问。例如，要访问 JSON 键 'success'，您只需这样做

$mobile_payment->success
// we can print it
echo $mobile_payment->success;

有些人比 JSON 更喜欢数组，因此他们将数组 $options 作为参数传递，以便将结果渲染为数组。

$options = [
  "JSON" => false
];

现在您可以将参数传递给所需的方法，以以您最舒适的方式检索数据。

$mobile_payment = AggregatorServiceProvider::mobile($array, $options);

Labyrinthe API

Labyrinthe-API 是一个类似于 Labyrinthe-RDC（一家基于数字的公司）所涵盖的其他许多服务的服务。

Labyrinthe 提供的 API 集合可扩展且全面。它支持我们独有的多种支付方式。从移动支付方式到银行，再到即将推出的加密货币，轻松集成支付解决方案。

Labyrinthe 移动服务

在移动部分，我们将查看与移动支付相关的所有服务。换句话说，进行支付并检查不同支付的结果。我们还提供沙盒，以便在进入高级版之前进行不同的支付测试。易于集成。

Labyrinthe 沙盒

如介绍中所述，本节涉及交易。也许本节最困难的部分将是理解方法（函数）中要传递的各种参数。但请放心，本节中都有解释，我们将从这里开始。

以下是一个代码片段，展示了如何填充其参数

$array = [
  "token" => "$2y$12$ngaXsXGwkrxpTAA.ubLXietv/Pdadfbx3OziwIH88inGU4sGi6ivm",
  "reference" => "First_TX",
  "phone" => "0896699032",
  "gateway" => "https://payment.labyrinthe-rdc.com/",
];

请使用Flexpay提供的信息填写表格后，复制以下代码段

$labyrinthe = LabyrintheServiceProvider::sandbox($array);

现在从您的控制器运行代码，并按需处理信息。所有信息都返回在变量 $labyrinthe 中。

Labyrinthe 检查交易

交易验证是一种旨在检查交易状态和/或从中提取某些详细信息的操作。这项练习涉及系统中的移动和卡交易。

有一些参数需要输入

以下是一个代码片段，展示了如何填充其参数

$array = [
  "token" => "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "gateway" => "https://xyz.cd/check/",
  "orderNumber" => "azertyytreza",
];

请使用Flexpay提供的信息填写表格后，复制以下代码段

$labyrinthe = LabyrintheServiceProvider::checkTransaction($array);

现在从您的控制器运行代码，并按需处理信息。所有信息都返回在变量 $labyrinthe 中。

Flexpay

FlexPaie 是一个支持所有电子支付方式（包括所有运营商和银行卡）的电子支付应用。它是所有商家和客户的理想解决方案。您不再需要为每个网络拥有一个电子账户 - 一个可以与Visa、Mastercard、Afrimoney、Orange Money、Airtel Money、M-Pesa 等网络操作的应用程序。

Flexpay 移动服务

在移动部分，我们将查看与移动支付相关的所有服务。换句话说，进行支付并检查不同支付的结果。

Flexpay 移动支付

如介绍中所述，本节涉及交易。也许本节最困难的部分将是理解方法（函数）中要传递的各种参数。但请放心，本节中都有解释，我们将从这里开始。

以下是一个代码片段，展示了如何填充其参数

$array = [
  "authorization" => "Orange",
  "merchant" => "orange",
  "type" => 1,
  // Continue with other params...
];

请使用Flexpay提供的信息填写表格后，复制以下代码段

$flexpay = FlexpayServiceProvider::mobile($array);

现在从您的控制器运行代码，并按需处理信息。所有信息都返回在变量 $flexpay 中。

Flexpay 检查移动结果

在每次交易中，您发送了一个callbackUrl，这是聚合器将交易结果发送到的URL。但需要检查这种数据发送，以确保正在处理（例如存储在数据库中）正确的信息。

在您以callbackUrl为端点的操作中，您将调用此静态函数

$flexpay = FlexpayServiceProvider::phoneResults($array);

此函数将自动检查结果并返回交易代码状态。如果一切顺利，它将返回 true 到 success 变量，否则返回 false。来自聚合器的信息处理将取决于函数的结果。您可以将其保存到数据库中，或进行计算，...

Flexpay卡

在本节中，我们关注银行交易。它将涵盖更多关于检查和检查结果的内容。

Flexpay 检查卡结果

在每次交易中，您发送了一个callbackUrl，这是聚合器将交易结果发送到的URL。但需要检查这种数据发送，以确保正在处理（例如存储在数据库中）正确的信息。

在您以callbackUrl为端点的操作中，您将调用此静态函数

$flexpay = FlexpayServiceProvider::cardResults($array);

此函数将自动检查结果并返回交易代码状态。如果一切顺利，它将返回 true 到 success 变量，否则返回 false。来自聚合器的信息处理将取决于函数的结果。您可以将其保存到数据库中，或进行计算，...

Flexpay 检查交易

交易验证是一种旨在检查交易状态和/或从中提取某些详细信息的操作。这项练习涉及系统中的移动和卡交易。

有一些参数需要输入

以下是一个代码片段，展示了如何填充其参数

$array = [
  "authorization" => "Orange",
  "gateway" => "https://xyz.cd/check/",
  "orderNumber" => "azertyytreza",
];

请使用Flexpay提供的信息填写表格后，复制以下代码段

$flexpay = FlexpayServiceProvider::checkTransaction($array);

现在从您的控制器运行代码，并按需处理信息。所有信息都返回在变量 $flexpay 中。