ariary/php-sdk

SDK officiel PHP pour l'API de paiement Ariary

v1.0.0 2025-12-04 13:19 UTC

Requires

• php: >=7.4
• guzzlehttp/guzzle: ^7.0

ISC

• Ariary

• api
• payment
• sms
• transfer
• ariary

README

SDK officiel PHP pour l'API de paiement Ariary. Permet d'envoyer des paiements, des SMS et des transferts d'argent.

Installation

composer require ariary/php-sdk

Configuration

use Ariary\AriarySDK;
use Ariary\Types\ApiConfig;

$config = new ApiConfig(
    apiKey: 'votre_api_key',
    secretId: 'votre_secret_id',
    projectId: 'votre_project_id'
);

$sdk = new AriarySDK($config);

Utilisation

Paiement

use Ariary\Types\CreatePaymentDto;

// Créer un paiement
$payment = $sdk->payment->createPayment(new CreatePaymentDto(
    code: 'PAY-K1X2Y3Z4-ABC123',
    amount: 5000,
    projectId: 'votre_project_id'
));

echo $payment->id;

// Récupérer tous les paiements
$allPayments = $sdk->payment->getAllPayments();

// Récupérer un paiement par ID
$payment = $sdk->payment->getPaymentById($payment->id);

// Mettre à jour le reste d'un paiement
$updated = $sdk->payment->updatePaymentRest($payment->id, 'TICKET123');

SMS

use Ariary\Types\SendSmsDto;
use Ariary\Types\BulkSmsDto;

// Envoyer un SMS à plusieurs numéros
$result = $sdk->sms->sendMultiSms(new SendSmsDto(
    phones: ['261345678901', '261345678902'],
    message: 'Bonjour!'
));

// Envoyer des messages différents en masse
$bulkResult = $sdk->sms->sendBulkSms(new BulkSmsDto(
    messages: [
        ['phones' => ['261345678901'], 'message' => 'Message 1'],
        ['phones' => ['261345678902'], 'message' => 'Message 2']
    ]
));

// Récupérer l'historique des SMS
$history = $sdk->sms->getSmsHistory();

// Récupérer un SMS par ID
$sms = $sdk->sms->getSmsById($smsId);

// Mettre à jour un SMS
$updated = $sdk->sms->updateSms($smsId, ['message' => 'Nouveau message']);

// Supprimer un SMS
$sdk->sms->deleteSms($smsId);

Transfer

use Ariary\Types\SendTransactionDto;

// Envoyer une transaction
$transaction = $sdk->transfer->sendTransaction(new SendTransactionDto(
    phone: '261345678901',
    amount: 5000
));

// Récupérer toutes les transactions
$allTransactions = $sdk->transfert->getAllTransactions();

// Récupérer une transaction par ID
$transaction = $sdk->transfert->getTransactionById($transactionId);

// Mettre à jour une transaction
$updated = $sdk->transfert->updateTransaction($transactionId, new SendTransactionDto(
    phone: '261345678902',
    amount: 10000
));

Types

Tous les types de données sont disponibles dans le namespace Ariary\Types:

use Ariary\Types\{
    CreatePaymentDto,
    PaymentResponseDto,
    SendSmsDto,
    BulkSmsDto,
    SendSmsResponseDto,
    MultiSmsResponseDto,
    BulkSmsResponseDto,
    ResponseSmsDto,
    SendTransactionDto,
    SendTransactionResponse,
    TransactionResponseDto,
    ApiConfig,
};

License

ISC