README

关于包

MoneyCare API 的 PHP 库 www.moneycare.su。MoneyCare 是商店 PIC 贷款的领先信用平台。2 分钟内提供来自银行和 MFIs 的超过 15 种解决方案

如何开始

1. 通过 composer require mitloshuk/moneycare 命令安装包，或将 "mitloshuk/moneycare": "^1.0" 添加到您的 composer.json
2. 通过 DI 初始化 MoneyCare/MoneyCare 或使用 $moneyCare = new \MoneyCare\MoneyCare($username, $password);，其中 $username 和 $password 是您访问 MoneyCare API 的认证数据

如何创建订单

1. 创建订单模型，如 $order = new \MoneyCare\Models\OrderCreation();
2. 创建商品模型，如 $good = new \MoneyCare\Models\Good();
3. 将价格和其他可选参数添加到商品模型 $good->setPrice(100)->setTitle('商品标题');。您可以使用具有 set 前缀的任何参数从文档中，如 ->setBrand('这是我的品牌')。
4. 对于预定义参数 goodType，可以使用字典 GoodTypesDictionary，例如 \MoneyCare\Dictionaries\GoodTypesDictionary::PRODUCT
5. 将必需的商品和点 ID 添加到您的订单模型 $order->addGood($good)->setPointId('point');。您可以使用具有 set 前缀的任何参数从文档中，如 ->setGenerateForm(true)。
6. 使用 $response = $moneyCare->createOrder($order); 执行订单模型的发送
7. 检查响应 $response->getIsAccepted() 或获取表单 URL，如果在前一个步骤中请求了它，则使用 $response->getFormUrl()
8. 对于预定义参数 creditTypes、formMode 和 creditStatus，您可以使用字典 CreditTypesDictionary、FormModesDictionary 和 CreditTypesDictionary。

因此，创建订单的示例代码将如下所示

$moneyCare = new \MoneyCare\MoneyCare($username, $password);

$order = new \MoneyCare\Models\OrderCreation();
$good = new \MoneyCare\Models\Good();

$good->setPrice(100)->setTitle('Good Title');
$order->addGood($good)->setPointId('point');

$response = $moneyCare->createOrder($order);

if ($response->getIsAccepted()) {
    echo $response->getFormUrl();
}

如何更新订单

1. 通过前一个响应中的 order id 获取现有订单的 $orderId = $response->getOrderId();
2. 创建新的订单模型，如 $newOrderData = new \MoneyCare\Models\OrderUpdating();
3. 创建另一个商品模型，如 $good2 = new \MoneyCare\Models\Good();
4. 将价格和其他可选参数添加到商品模型 $good2->setPrice(100)->setTitle('商品标题');。
5. 将商品添加到您的新订单模型 $newOrderData->addGood($good)。
6. 使用 $moneyCare->updateOrder($orderId, $newOrderData); 执行订单模型的发送
7. 没有从请求中返回响应，但您可以使用 details request 获取信息

更新前一个示例订单的代码如下所示

$orderId = $response->getOrderId();
$newOrderData = new \MoneyCare\Models\OrderUpdating();
$good2 = new \MoneyCare\Models\Good();

$good2->setPrice(100)->setTitle('Good Title');
$newOrderData->addGood($good2);

$moneyCare->updateOrder($orderId, $newOrderData);

如何获取订单详情

1. 通过前一个响应中的 order id 获取现有订单的 $orderId = $response->getOrderId();
2. 执行请求，如 $response = $moneyCare->orderDetails($orderId);
3. 响应将包含文档中的所有参数，它们将通过其名称以 get 前缀访问

获取详情的代码如下所示

$orderId = $response->getOrderId();
$response = $moneyCare->orderDetails($orderId);
echo $response->getCreditLimit();

如何更改订单状态

1. 通过前一个响应中的 order id 获取现有订单的 $orderId = $response->getOrderId();
2. 执行请求，如 $moneyCare->updateStatus($orderId, OrderStatusesDictionary::DELIVERY);
3. 第二个方法参数是 orderStatus，它是预定义的，因此您可以使用 OrderStatusesDictionary 以更简单的使用方式
4. 没有从请求中返回响应，但您可以使用 details request 获取信息

获取详情的代码如下所示

$orderId = $response->getOrderId();
$moneyCare->updateStatus($orderId, OrderStatusesDictionary::DELIVERY);