README

这是一个什么程序？

这是一个用于自动处理p2p交易的程序。程序使用Payme API。

1. 程序运行要求

• >= PHP v7.4
• >= Composer v1.10.1

2. 安装

要完全使用此程序，您需要安装composer。

$ composer install

3. 连接到Payme

我们通过使用App\Payme\Api\Api类来连接到Payme。通过这个类，我们可以执行所有与Payme相关的操作。让我们通过这个类进入我们的第一个Payme控制面板。

<?php
$payme = new Api();  
$payme->setCredentials(['login' => 'paymega ulangan telefon raqam', 'password' => 'paymedagi parol']);  
$payme->login()->sendActivationCode();

注意！我们只进入一次，为了获取“重要”信息。之后不需要再次登录。以下列出的“重要”信息请仔细阅读。

我们可以通过setCredentials([])方法设置我们的Payme账户的登录密码。需要发送一个massiv。在数组中必须包含login和password键。login - 这是您在Payme中的名称，编号应按901234564的格式编写。password应直接编写。输入这些信息后，您会收到来自Payme的短信到您的手机。您可以通过activate方法输入此代码

<?php
$payme = new Api();  
$payme->activate('telefonga kelgan kod')->registerDevice();  
$payme->setCredentials(['login' => 'paymega ulangan telefon raqam', 'password' => 'paymedagi parol']);  
$device_id = $payme->getDevice(); // !!! MA'LUMOTLAR BAZAGA TEGISHLI TARTIBDA SAQLANSIN  
$cards = $payme->getMyCards(); // !!! MA'LUMOTLAR BAZAGA TEGISHLI TARTIBDA SAQLANSIN | ID raqam massivning "_id" indeksida bo'ladi

如果您收到来自Payme的"Payme API设备已连接"短信，则表示一切顺利。然后，继续保存所需信息。

重要信息

1. 设备ID
2. 卡ID

当通过API访问Payme时，会话持续15分钟，然后API密钥会更新。在这种情况下，为了避免再次登录，我们需要保存设备ID。可以通过setDevice方法输入设备ID来获取活动的会话密钥（您不需要这样做，程序会自动找到会话密钥）。在处理限额和卡时，必须输入第一个凭证和设备ID。设备ID通过setDevice方法输入。

<?php
$payme = new Api();
$payme->setCredentials(['login' => 'paymega ulangan telefon raqam (Telefon raqam 901234565 formatda bo`lishi kerak)', 'password' => 'paymedagi parol']);
$payme->setDevice('device id string');

之后可以监视所有操作。

查看Payme中的所有交易

使用getAllCheques或cheques方法可以查看所有交易。这两个方法执行相同的功能，但getAllCheques不是链式调用的。

<?php
$payme = new Api();  
$payme->setCredentials(['login' => 'paymega ulangan telefon raqam (Telefon raqam 901234565 formatda bo`lishi kerak)', 'password' => 'paymedagi parol']); 
$payme->setDevice('device id string'); 
$cheques = $payme->getAllCheques(); 
// yoki
$cheques = $payme->cheques();

从交易中查找相关的注释性支付

如果您想自动化P2P支付，这将非常有用。添加了findByComment方法来检查注释性支付。示例

<?php
$payme = new Api();  
$payme->setCredentials(['login' => 'paymega ulangan telefon raqam (Telefon raqam 901234565 formatda bo`lishi kerak)', 'password' => 'paymedagi parol']);  
$payme->setDevice('device id string'); 

// Bitta kartadagi tranzaksiyalar orasidan izoh orqali qidirish  
$payme->selectCard('karta id raqami')->findByComment('izoh', 0); // 0 ni o'rniga kerakli summa yozilsin  
  
// Barcha kartalardagi tranzaksiyalar orasidan izoh orqali qidirish  
$payme->cheques()->findByComment('izoh', 0);

筛选交易

要筛选交易，需要将包含筛选参数的数组传递给getAllCheques或cheques方法之一。筛选参数如下

1. from 此参数接受3个元素的数组。元素是day, month, year。当为month赋值时，需要减去1个月。也就是说，要找到7月的记录，需要写成6月（这在Payme中是有效的）。
2. count 此参数接受整数。其作用是确定要获取多少笔交易。
3. card 此参数接受卡号ID。其作用是获取指定卡号的所有交易。
4. to 此参数与from相同。但它将获取到指定日期为止的所有交易。
5. group 默认值为time
6. offset 默认值为0

示例

API使用的示例已在index.php文件中编写。

注意！

本手册由 Sanjarbek Sobirjonov (Telegram @sobirjonovs) 编写。如果在程序或手册中发现任何错误，我们将非常高兴收到您的 pull request 或反馈。