API Entegrasyonu: Başlangıç Rehberi

Metal Pay API'si ile ödeme sisteminizi entegre etmek oldukça basittir. Bu rehberde, sıfırdan başlayarak API entegrasyonunu nasıl yapacağınızı öğreneceksiniz.

Başlangıç

İlk adım olarak Metal Pay dashboard'unuzdan API anahtarınızı almanız gerekiyor. API anahtarlarınızı güvenli tutun ve asla public repository'lere commit etmeyin.

Temel Entegrasyon

1. API Anahtarınızı Ayarlayın

const API_KEY = 'sk_live_your_api_key_here';
const BASE_URL = 'https://api.metalpay.com/v1';

2. İlk Ödeme İsteği

async function createPayment(amount, cardToken) {
  const response = await fetch(`${BASE_URL}/payments`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      amount: amount,
      currency: 'TRY',
      card_token: cardToken,
      description: 'Sipariş #12345'
    })
  });
  
  return await response.json();
}

3. Hata Yönetimi

Tüm API isteklerinde uygun hata yönetimi yapmayı unutmayın. Metal Pay API'si standart HTTP durum kodlarını kullanır.

Sonraki Adımlar

• Webhook entegrasyonu
• Kart tokenizasyonu
• İade işlemleri
• Raporlama ve analitik

Detaylı dokümantasyon için API dokümantasyon sayfamızı ziyaret edebilirsiniz.