PHP
PHP SDK
PHP 8+ için resmi kütüphane: fatura oluşturma, çekim ve webhook imza doğrulaması tek sınıfta.
Kurulum
Composer ile (önerilen):
composer require mercanpay/mercanpay-php
Composer kullanmıyorsanız zip dosyasını indirip src/ klasörünü projenize kopyalayın ve iki dosyayı require edin. Yalnızca ext-curl ve ext-json gerekir.
Fatura oluşturma
use MercanPay\MercanPay;
$zp = new MercanPay('https://mercanpay.com', getenv('MERCANPAY_API_KEY'));
// USD fiyatlı fatura: müşteri coini ödeme sayfasında seçer
$invoice = $zp->createUsdInvoice('25', [
'order_id' => 'siparis-1001',
'callback_url' => 'https://magazaniz.com/mercanpay-webhook.php',
]);
header('Location: ' . $invoice['payment_url']);
Webhook doğrulama
$body = file_get_contents('php://input');
if (!MercanPay::verifyWebhook(getenv('MERCANPAY_WEBHOOK_SECRET'), $body, $_SERVER['HTTP_X_MERCANPAY_SIGNATURE'] ?? '')) {
http_response_code(401);
exit;
}
$event = json_decode($body, true);
if ($event['type'] === 'invoice.paid') {
// siparişi ödendi olarak işaretleyin (aynı olay birden fazla gelebilir)
}
Çekim
$w = $zp->createWithdrawal('USDT', '10', 'T...', 'odeme-2026-001');
echo $w['status']; // queued -> processing -> completed
API anahtarı withdrawals yetkisine sahip olmalı ve adres panelde 2FA'sız çekim için kayıtlı olmalıdır. Tüm uç noktalar için dokümantasyona bakın.