README

Официальный SDK для приёма платежей через anore. Без зависимостей, только расширения curl и json из ядра PHP. PHP 7.4+.

Структура

php/
├── composer.json
└── src/
    ├── Client.php             createPayment, getPayment (cURL + ретраи)
    ├── Webhooks.php           verify / parse
    ├── Model/
    │   ├── Model.php          база моделей
    │   ├── Payment.php        модель платежа
    │   └── WebhookEvent.php   модель события вебхука
    └── Exception/             иерархия ошибок

Установка

Composer

composer require anore/sdk

require 'vendor/autoload.php';
use Anore\Client;
use Anore\Webhooks;

Без Composer — подключите PSR-4 автозагрузчик на папку src/ с префиксом Anore\.

Быстрый старт

$anore = new Anore\Client('an_live_xxxxxxxxxxxxxxxx');

// 1. создать счёт
$payment = $anore->createPayment([
    'amount'      => 1500,
    'description' => 'Подписка Pro',
    'orderId'     => 'order_42',
    'shopId'      => 1, // обязателен для аккаунтовых ключей (an_*)
]);
echo $payment->paymentUrl(); // отправьте клиента сюда

// 2. проверить статус
$status = $anore->getPayment($payment->id());
echo $status->status(); // paid

Проверка вебхука

При оплате anore шлёт POST на ваш URL с заголовком Anore-Signature. Проверяйте подпись по сырому телу запроса (не декодированному JSON):

use Anore\Webhooks;
use Anore\Exception\SignatureException;

$raw = file_get_contents('php://input'); // сырое тело
$sig = $_SERVER['HTTP_ANORE_SIGNATURE'] ?? '';

try {
    $event = Webhooks::parse($raw, $sig, getenv('ANORE_WEBHOOK_SECRET'));
    if ($event->isSucceeded()) {
        // отгрузить заказ $event->id() / $event->orderId()
    }
    http_response_code(200);
} catch (SignatureException $e) {
    http_response_code(403); // подпись не сошлась
}

Обработка ошибок

use Anore\Exception\ValidationException;
use Anore\Exception\AuthenticationException;
use Anore\Exception\ApiConnectionException;

try {
    $anore->createPayment(['amount' => 1500, 'description' => 'Заказ', 'shopId' => 1]);
} catch (ValidationException $e) {       // 400 — кривой запрос
} catch (AuthenticationException $e) {   // 401 — неверный ключ
} catch (ApiConnectionException $e) {    // сеть недоступна
}

Справка

Ошибки: ValidationException (400), AuthenticationException (401), ForbiddenException (403), NotFoundException (404), ServerException (5xx), ApiConnectionException (сеть), SignatureException (подпись). База — AnoreException, у ApiException есть getStatus() и getRequestId().

Полная документация: https://anore.cc/docs