Geliştiriciler İçin Nodopay

Hızlı başlangıç: ödeme linki oluşturma

Sandbox anahtarınızla aşağıdaki istek, müşterinize gönderebileceğiniz bir ödeme linki üretir. Yanıtta linkin adresi ve kimliği döner.

curl -X POST https://api.nodopay.com/v1/payment-links \
  -H "Authorization: Bearer sk_test_••••••••" \
  -H "Idempotency-Key: 8f2c1a7e-…" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1250.00,
    "currency": "TRY",
    "description": "Fatura #2026-0142",
    "customer": { "name": "Örnek Bayi Ltd.", "email": "muhasebe@ornekbayi.com" },
    "installments": [1, 3, 6],
    "expires_at": "2026-12-31T23:59:59+03:00"
  }'

Temel uç noktalar

Webhook’lar

Olaylar sisteminize POST isteğiyle iletilir. Her isteğin gövdesi X-Nodopay-Signature başlığında HMAC-SHA256 ile imzalanır. Yanıt 2xx değilse istek artan aralıklarla 24 saat boyunca yeniden denenir.

Olay türleri: payment.succeeded payment.failed refund.created link.opened link.paid invoice.overdue subscription.renewed

<?php
// Webhook imzasını doğrulama (HMAC-SHA256)
$payload   = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_NODOPAY_SIGNATURE'] ?? '';
$expected  = hash_hmac('sha256', $payload, getenv('NODOPAY_WEBHOOK_SECRET'));

if (!hash_equals($expected, $signature)) {
    http_response_code(401);
    exit;
}

$event = json_decode($payload, true, 512, JSON_THROW_ON_ERROR);
if ($event['type'] === 'payment.succeeded') {
    // Siparişi / cariyi güncelleyin
}
http_response_code(200);

Güvenlik kuralları

• API anahtarları yalnızca sunucu tarafında kullanılmalı; tarayıcıya veya mobil uygulamaya gömülmemelidir.
• Anahtarlar kapsam (yetki) ve IP beyaz listesiyle sınırlandırılabilir.
• Kart verisi API’ye gönderilmez; kart girişi Nodopay’in güvenli ödeme sayfasında veya gömülü formda yapılır.
• Tüm istekler TLS 1.2+ zorunludur.

SDK’lar

PHP, .NET, Node.js ve Python için resmi kütüphaneler; ödeme, link, iade ve webhook doğrulama yardımcılarını içerir.