Size nasıl yardımcı olabiliriz?

Pay2out Ödeme Entegrasyonu

Bu döküman, Pay2out ödeme sistemiyle entegrasyon yapmak isteyen geliştiriciler için hazırlanmıştır. Ödeme başlatma, ödeme sonuçlarını alma ve callback işlemlerini kapsar.

Entegrasyon Adımları

1. API anahtarlarınızı güvenli bir şekilde saklayın
2. Ödeme başlatma isteği oluşturun
3. Müşterileri ödeme sayfasına yönlendirin
4. Callback URL ile ödeme durumunu takip edin
5. Gerekirse ödeme durumunu API üzerinden sorgulayın

Kullanıcı Hesabı

Pay2out platformunun tüm özelliklerinden yararlanmak için bir hesaba sahip olmanız gerekir. Hesap kurulumu ve yönetimi hakkında bilmeniz gereken her şey burada.

Hesap Oluşturma

Hesap oluşturmak için şu adımları izleyin:

1. pay2out.com adresine gidin ve "Kayıt Ol" butonuna tıklayın
2. Gerekli bilgileri doldurun (e-posta, şifre, işletme bilgileri)
3. E-posta doğrulama adımını tamamlayın
4. İşletme kimlik doğrulama sürecini takip edin
5. API anahtarlarınızı güvenli bir şekilde saklayın

API Anahtarları

Pay2out panelinde "Ayarlar > API" menüsünden API anahtarlarınızı görüntüleyebilir ve yönetebilirsiniz. Her bir anahtar için izinleri ve erişim kapsamını ayarlayabilirsiniz.

Ürün Özellikleri

Pay2out, işletmenizin ihtiyaçlarına uygun çeşitli ödeme çözümleri sunar. Platformun sunduğu temel özellikler:

Ödeme Bağlantıları

Tekil ürünler veya hizmetler için özel ödeme bağlantıları oluşturabilir ve bunları müşterilerinizle e-posta, SMS veya sosyal medya üzerinden paylaşabilirsiniz.

Tekrarlayan Ödemeler

Abonelik modelli işletmeler için otomatik tekrarlayan ödeme planları oluşturabilirsiniz.

Çoklu Para Birimi Desteği

TRY, USD, EUR ve diğer popüler para birimlerinde ödeme kabul edebilirsiniz.

Özelleştirme Seçenekleri

Pay2out ödeme sayfalarını ve formlarını markanıza uygun şekilde özelleştirebilirsiniz.

Tema Özelleştirme

Ödeme sayfalarının renk şemasını, yazı tiplerini ve logonuzu markanızla uyumlu olacak şekilde ayarlayabilirsiniz.

Form Alanları

Ödemeler sırasında müşterilerinizden toplamak istediğiniz özel alanlar ekleyebilirsiniz.

Ödeme Yöntemleri

Pay2out çeşitli ödeme yöntemlerini ve gateway'leri destekler.

Desteklenen Ödeme Yöntemleri

• Kredi/Banka Kartları (Visa, MasterCard, AmEx)
• Havale/EFT
• Kapıda Ödeme
• Dijital Cüzdanlar

Ödeme Başlatma

Ödeme işlemi başlatmak için aşağıdaki API endpoint'ine POST isteği göndermeniz gerekmektedir:

POST https://api.pay2out.com/api/payment/create

Güvenlik Önlemleri

Pay2out ödeme işlemlerinde en yüksek güvenlik standartlarını sağlar.

API Anahtarları Güvenliği

API anahtarlarınızı güvende tutmak için alınması gereken önlemler:

• API anahtarlarınızı hiçbir zaman client-side kodunda saklamayın
• Anahtarları environment variable olarak kullanın
• Düzenli olarak anahtarlarınızı yenileyin

Callback Güvenliği

Callback istekleri, özel bir imza ile güvenli hale getirilir. Gelen isteğin geçerli olduğunu doğrulamak için HTTP header'ındaki X-Signature değerini kontrol etmelisiniz.

Dijital İndirmeler

Dijital ürün satışlarınız için Pay2out'un dijital teslimat özelliklerini kullanabilirsiniz.

Dijital Ürün Kurulumu

Dijital ürünleri satmak için aşağıdaki adımları izleyin:

1. Pay2out panelinde "Ürünler" sekmesine gidin
2. "Dijital Ürün Ekle" butonuna tıklayın
3. Ürün bilgilerini ve dosyalarını yükleyin
4. Teslimat ayarlarını yapılandırın

Email Pazarlama

Pay2out'un email entegrasyonları ve pazarlama özellikleri ile müşterilerinizle iletişimde kalın.

Otomatik Email Bildirimleri

Pay2out şu durumlarda otomatik email gönderir:

• Ödeme başarılı olduğunda
• Ödeme başarısız olduğunda
• Abonelik yenilendiğinde
• Abonelik sona erdiğinde

Email Şablonları

Pay2out panelinde "Ayarlar > Bildirimler" bölümünden email şablonlarını markanıza uygun şekilde özelleştirebilirsiniz.

API Referansı

Pay2Out, geliştiricilerin kendi uygulamalarına ödeme işlevselliği entegre etmelerini sağlayan kapsamlı bir API seti sunar. Bu bölümde tüm API'lerin detaylı açıklamalarını bulabilirsiniz.

POST https://www.pay2out.com/api/payment/create

curl -X POST https://www.pay2out.com/api/payment/create \
  -H "Content-Type: application/json" \
  -d '{
    "signature_secret": "YOUR_SIGNATURE_SECRET",
    "amount": 150,
    "currency": "TRY",
    "description": "Sipariş ödemesi",
    "has_installment": true,
    "customer_name": "Ali Veli",
    "customer_email": "[email protected]",
    "customer_phone": "5551234567",
    "customer_address": "Atatürk Mah. Cumhuriyet Cad. No:123 D:5",
    "customer_city": "İstanbul",
    "customer_district": "Kadıköy",
    "customer_postal_code": "34752",
    "reference": "OD-123456789",
    "order_number": "INV-123456785",
    "expires_at": "2025-05-01T15:00:00Z",
    "items": [
      {
        "product_id": "SKU-001",
        "product_name": "Wireless Kulaklık",
        "product_price": 75.00,
        "product_image": "https://example.com/images/kulaklik.jpg",
        "product_category": "Elektronik",
        "quantity": 1
      },
      {
        "product_id": "SKU-002",
        "product_name": "Telefon Kılıfı",
        "product_price": 25.00,
        "product_image": "https://example.com/images/kilif.jpg",
        "product_category": "Aksesuar",
        "quantity": 3
      }
    ]
  }'

{
  "success": true,
  "message": "Ödeme işlemi başlatıldı",
  "data": {
    "payment_uuid": "85aa3555-5ccc-4599-ad2a-ed6cda5f6608",
    "order_number": "INV-123456785",
    "amount": "10.00",
    "currency": "TRY",
    "status": "pending",
    "payment_url": "https://pay.payhesap.com/order/85aa3555-5ccc-4599-ad2a-ed6cda5f6608",
    "expires_at": "2025-05-01T15:00:00Z",
    "customer_info": {
      "name": "Ali Veli",
      "email": "[email protected]",
      "phone": "5551234567",
      "address": "Atatürk Mah. Cumhuriyet Cad. No:123 D:5",
      "city": "İstanbul",
      "district": "Kadıköy",
      "postal_code": "34752"
    }
  }
}

{
  "success": false,
  "message": "Geçersiz imza anahtarı",
  "error_code": "INVALID_SIGNATURE"
}

GET https://www.pay2out.com/api/payment/{payment_uuid}/status

curl -X GET https://www.pay2out.com/api/payment/85aa3555-5ccc-4599-ad2a-ed6cda5f6608/status \
  -H "Content-Type: application/json" \
  -H "X-Signature-Secret: YOUR_SIGNATURE_SECRET"

{
  "success": true,
  "data": {
    "payment_uuid": "85aa3555-5ccc-4599-ad2a-ed6cda5f6608",
    "order_number": "INV-123456785",
    "reference": "OD-123456789",
    "status": "completed",
    "amount": "10.00",
    "currency": "TRY",
    "customer": {
      "name": "Ali Veli",
      "email": "[email protected]",
      "phone": "5551234567",
      "address": "Atatürk Mah. Cumhuriyet Cad. No:123 D:5",
      "city": "İstanbul",
      "district": "Kadıköy",
      "postal_code": "34752"
    },
    "created_at": "2025-04-27T16:54:54+03:00",
    "updated_at": "2025-04-27T16:55:08+03:00"
  }
}

{
  "success": false,
  "message": "Geçersiz imza anahtarı",
  "error_code": "INVALID_SIGNATURE"
}

{
  "payment_uuid": "85aa3555-5ccc-4599-ad2a-ed6cda5f6608",
  "order_number": "INV-123456785",
  "reference": "OD-123456789",
  "status": "completed",
  "amount": "10.00",
  "currency": "TRY",
  "customer": {
    "name": "Ali",
    "surname": "Veli",
    "email": "[email protected]",
    "phone": "5551234567"
  },
  "transaction_id": "TR123456789",
  "installment": 1,
  "gateway": "esnekpos",
  "timestamp": 1745762108
}

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_SIGNATURE'] ?? '';
$secretKey = 'your_signature_secret_key';

$calculatedSignature = hash_hmac('sha256', $payload, $secretKey);

if (hash_equals($calculatedSignature, $signature)) {
    // İmza doğru, işleme devam et
    $data = json_decode($payload, true);
    // Ödeme verilerini işle
} else {
    // İmza geçersiz, isteği reddet
    http_response_code(403);
    echo json_encode(['error' => 'Invalid signature']);
}