Ödemeler ve çekimler/Payment API

Ödeme API'si

2328.io Ödeme API'si ile kripto para ödeme oturumları oluşturun ve yönetin.

Ödeme API'si, ödeme oturumları oluşturmanıza, müşterileri hosted checkout'a yönlendirmenize ve ödeme durumunu takip etmenize olanak tanır.

Ödeme oluştur

Bir ödeme oturumu oluşturur ve müşterinin ödeme yapması için bir URL döner.

İstek parametreleri

Alan	Tip	Gerekli	Açıklama
`amount`	decimal	evet	Para biriminde ödeme tutarı, örn. `100.00`
`currency`	string	evet	Fiat para birimi (USD, EUR, RUB, …) veya kripto para (USDT, TRX, BTC, …)
`order_id`	string	evet	Sipariş ID'niz, örn. `ORDER-12345` (en fazla 128 karakter)
`to_currency`	string	hayır	Önceden seçilmiş kripto para
`network`	string	hayır*	Ağ kodu (`to_currency` ayarlandığında veya `currency` bir kripto para olduğunda gereklidir)
`url_return`	string	hayır	Ödemeden sonra yönlendirme URL'si, örn. `https://your-site.com/return`
`url_success`	string	hayır	`url_return` için alternatif
`url_callback`	string	hayır	Webhook bildirimleri için URL, örn. `https://your-site.com/webhook`
`invite_code`	string	hayır	Yönlendiren kodu
`fee_split`	decimal	hayır	Ödeyene aktarılan merchant ücreti payı, 0–100 (%). 0 = merchant tamamen öder, 100 = ödeyen tamamen öder. Proje düzeyindeki ayarı geçersiz kılar. Örnek: `30` (ödeyen ücretin %30'unu karşılar).
`price_markup`	decimal	hayır	Fatura tutarı üzerinde markup veya iskonto, −99 ile 100 (%) arası. Proje düzeyindeki ayarı geçersiz kılar. Örnek: `5` (+%5) veya `-10` (%10 indirim).
`description`	string	hayır	İsteğe bağlı fatura açıklaması (en fazla 200 karakter). Ödeme sayfasında ödeyene gösterilir. Örnek: `Premium plan — Order #12345`.
`ttl_seconds`	int	hayır	Faturanın saniye cinsinden geçerlilik süresi, `300` (5 dakika) ile `86400` (24 saat) arasında. Bu sürenin sonunda fatura sona erer ve artık ödenemez. Varsayılan: `3600` (1 saat). Örnek: `3600`.

Yanıt

JSON

{
  "state": 0,
  "result": {
    "uuid": "abc123-def456-...",
    "order_id": "ORDER-12345",
    "amount": "100.00",
    "currency": "USD",
    "amount_usd": "100.00",
    "exchange_rate": null,
    "url": "https://2328.io/pay/abc123-def456-...",
    "tg_deeplink": "https://t.me/my2328bot?start=pay_abc123-def456-...",
    "expires_at": "2026-01-11T21:00:00Z",
    "created_at": "2026-01-11T20:00:00Z",
    "payer_currency": "USDT",
    "payer_amount": "100.50",
    "network": "TRX-TRC20",
    "address": "TXYZabc123...",
    "payment_status": "check",
    "txid": null,
    "payment_amount": null,
    "qr": "data:image/png;base64,iVBORw0..."
  }
}

Müşteriyi ödemeyi tamamlamak için result.url adresine yönlendirin.
tg_deeplink — Telegram MiniApp üzerinden ödeme için Telegram bot deeplink'i.
qr — yatırma adresinin Base64 ile encode edilmiş QR kodu (data URI). Bir adres zaten atandığında mevcuttur (network, to_currency ile birlikte ayarlandığında veya currency bir kripto para olduğunda); aksi takdirde null.
txid, payment_amount — müşteri ödeme yapana kadar null'dur. İşlem zincir üzerinde tespit edildiğinde doldurulur. Bunun ne zaman olacağını öğrenmek için payment_status: paid webhook'unu dinleyin.
exchange_rate — dönüştürme henüz uygulanabilir değilse null (örn. fiat → kripto kuru henüz kilitlenmedi). Bir ödeyen para birimi seçildiğinde doldurulur.

Credentials

Project UUIDAPI key

RequestPOST/v1/payment

curl -X POST https://api.2328.io/api/v1/payment \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyShop/1.0 (+https://myshop.example)" \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Response

Click Try it to see the response here.

Ödeme bilgisi

Mevcut ödeme durumunu uuid veya order_id ile alın.

İstek parametreleri

Alan	Tip	Gerekli	Açıklama	Değerler
`uuid`	string	evet*	Ödeme UUID (oluşturmadaki `result.uuid`'den)
`order_id`	string	evet*	Sipariş ID'niz

uuid veya order_id'den en az biri gereklidir.

RequestPOST/v1/payment/info

curl -X POST https://api.2328.io/api/v1/payment/info \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyShop/1.0 (+https://myshop.example)" \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Response

Click Try it to see the response here.

Ödeme listesi

Filtreleme ve sayfalama ile tüm ödemelerin bir listesini alın.

İstek parametreleri

Alan	Tip	Gerekli	Açıklama
`status`	string	hayır	Ödeme durumuna göre filtre (bkz. References)
`date_from`	date	hayır	Başlangıç tarihi (YYYY-MM-DD), örn. `2026-01-01`
`date_to`	date	hayır	Bitiş tarihi (YYYY-MM-DD), örn. `2026-01-31`
`page`	int	hayır	Sayfa numarası, varsayılan `1`
`per_page`	int	hayır	Sayfa başına öğe, varsayılan `15`, en fazla `5000`

RequestPOST/v1/payment/list

curl -X POST https://api.2328.io/api/v1/payment/list \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyShop/1.0 (+https://myshop.example)" \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Response

Click Try it to see the response here.