搞定线上支付合规！如何用Composer和retailcrm/atol-online-client轻松集成ATOL.Online

<code class="bash">composer require retailcrm/atol-online-client</code>

<pre class="brush:php;toolbar:false;"><?php

require 'vendor/autoload.php'; // 引入 Composer 自动加载文件

use AtolOnlineClient\AtolOnline;
use AtolOnlineClient\Configuration\Connection;
use AtolOnlineClient\AtolOnlineApi;
use AtolOnlineClient\Configuration;
use AtolOnlineClient\Request\V4\PaymentReceiptRequest;
use AtolOnlineClient\Entities\V4\Item; // 引入商品实体
use AtolOnlineClient\Entities\V4\Payment; // 引入支付实体
use AtolOnlineClient\Entities\V4\Vat; // 引入税率实体
use GuzzleHttp\Client; // 现代 Composer 环境通常使用 GuzzleHttp\Client

// 1. 初始化 AtolOnline 客户端
$atol = new AtolOnline();

// 2. 配置连接参数
$connection = new Connection();
$connection->version = AtolOnlineApi::API_VERSION_V4; // 指定 API 版本
$connection->login = 'your_atol_login'; // 替换为你的 ATOL.Online 登录名
$connection->pass = 'your_atol_password'; // 替换为你的 ATOL.Online 密码
$connection->group = 'your_group_code'; // 替换为你的 ATOL.Online 组代码

// 3. 将连接配置添加到主配置对象
$config = new Configuration();
$config->connections = [$connection];

// 4. 创建 Guzzle HTTP 客户端实例
$httpClient = new Client(); 

// 5. 使用配置和 HTTP 客户端创建 ATOL.Online API 实例
$api = $atol->createApi($httpClient, $connection);

// 6. 准备一个销售收据请求对象 (V4 版本)
$request = new PaymentReceiptRequest();
$request->external_id = 'order_12345'; // 你的系统中的订单ID
$request->timestamp = (new DateTime())->format('d.m.Y H:i:s'); // 当前时间

// 填充客户信息
$request->receipt->client->email = 'user@example.com';
$request->receipt->client->name = '张三';
$request->receipt->client->phone = '+79001234567';

// 填充商品信息
$item1 = new Item();
$item1->setName('商品 A');
$item1->setPrice(100.00);
$item1->setQuantity(1.0);
$item1->setSum(100.00);
$item1->setTax( (new Vat())->setType('none') ); // 无税

$item2 = new Item();
$item2->setName('商品 B');
$item2->setPrice(50.00);
$item2->setQuantity(2.0);
$item2->setSum(100.00);
$item2->setTax( (new Vat())->setType('vat10') ); // 10% 增值税

$request->receipt->items = [$item1, $item2];
$request->receipt->total = 200.00; // 总金额

// 填充支付信息
$payment = new Payment();
$payment->setType('electronically'); // 电子支付
$payment->setSum(200.00);
$request->receipt->payments = [$payment];

$request->receipt->sno = 'osn'; // 税务系统：通用系统 (General System)

// 7. 将请求对象序列化为 API 期望的格式
$paymentReceiptRequest = $atol->serializeOperationRequest($request);

// 8. 发送销售请求
try {
    $response = $api->sell($paymentReceiptRequest);

    if ($response) {
        // 9. 反序列化 API 响应
        $postOperationResponse = $atol->deserializeOperationResponse($response);
        echo "财政化成功！UUID: " . $postOperationResponse->uuid . "\n";
        // 进一步处理响应，例如保存 UUID 到数据库，或根据 status 进行后续操作
        if ($postOperationResponse->status === 'done') {
            echo "操作已完成。\n";
        }
    }
} catch (\Exception $e) {
    echo "财政化失败: " . $e->getMessage() . "\n";
    // 处理错误，例如记录日志，通知管理员，或根据错误类型进行重试
}