Hızlı başlangıç

Bu sayfa ilk yatırımı uçtan uca çalıştırmak için gereken en kısa yolu gösterir. Ayrıntılar ilgili sayfalarda.

1. Yatırım talebi oluşturun

İstek her zaman sunucunuzdan atılır; secKey tarayıcıya veya mobil uygulamaya asla çıkmamalıdır.

curl -X POST https://api.tlhavale.com/api/payment/deposit/with-partner \
  -H "Content-Type: application/json" \
  -d '{
    "auth": { "apiKey": "tlh_pk_…", "secKey": "tlh_sk_…" },
    "customer": { "fullName": "Ayşe Demir", "username": "aysed", "id": "48213" },
    "amount": 1500,
    "transactionId": "dep-2026-000184",
    "returnUrl": "https://siteniz.com/hesabim"
  }'

Başarılı yanıtın içinde bir token vardır:

{
  "status": true,
  "token": "eyJhbGciOi…",
  "deposit": { "_id": "6ad9…", "transactionId": "dep-2026-000184", "amount": 1500, "status": "PROCESSING" }
}

2. Müşteriyi ödeme sayfasına yönlendirin

https://pay.tlhavale.com/deposit?token=eyJhbGciOi…

Token 30 dakika geçerlidir. Müşteri 10 dakika içinde ödemeyi yapıp "Ödemeyi yaptım" demezse talep zaman aşımına uğrar.

3. Bildirimi karşılayın

Yatırım bildirim adresinize şu istek gelir:

{
  "transactionId": "dep-2026-000184",
  "status": "CONFIRMED",
  "amount": 1500,
  "hash": "5f1c…",
  "type": "deposit"
}

İmzayı doğrulayın, CONFIRMED ise müşterinin bakiyesini amount kadar artırın ve HTTP 200 dönün. Doğrulama kodu için Bildirim (callback) sayfasına bakın.

Yerelde deneme

Bildirim adresiniz internete açık olmalıdır. Geliştirme sırasında bir tünel (ör. ngrok, Cloudflare Tunnel) kullanıp adresi hesap yöneticinize iletebilirsiniz.