Hızlı Başlangıç: Ödeme Oturumu Başlatma
MutabıkPOS B2B Sanal POS entegrasyonu tek bir POST isteğiyle başlar. Sunucunuzdan /api/v1/checkout/sessions uç noktasına firma API anahtarınızla birlikte sipariş tutarı ve geri dönüş URL'sini iletmeniz yeterlidir.
```json
POST /api/v1/checkout/sessions
Headers:
Content-Type: application/json
X-POS-API-Key: YOUR_FIRM_API_KEY
Body:
{
"amountTl": 1500.00,
"currency": "USDT_TRC20",
"customerName": "Ahmet Yılmaz",
"customerContact": "ahmet@example.com",
"successUrl": "https://siteniz.com/siparis/basarili",
"cancelUrl": "https://siteniz.com/sepet"
}
```
Dönen yanıttaki checkoutUrl adresine müşterinizi yönlendirmeniz yeterlidir.
Webhook Bildirimleri ile Otomatik Sipariş Tamamlama
Müşteri kripto transferini gerçekleştirdiğinde MutabıkPOS zincir üzerinde işlemi doğrular ve panelinizde tanımladığınız Webhook URL adresine aşağıdaki payload'u gönderir:
```json
POST /api/pos-webhook
Headers:
Content-Type: application/json
X-POS-Event: checkout.completed
Body:
{
"event": "checkout.completed",
"orderCode": "POS-20261116-8492",
"sessionToken": "pos_sess_abc123",
"status": "completed",
"amountTl": 1500.00,
"cryptoAmount": 31.25,
"currency": "USDT_TRC20",
"txId": "e1f2a3...",
"txVerified": true,
"timestamp": "2026-11-16T14:30:00.000Z"
}
```
Hata Yönetimi ve Güvenlik Standartları
Tüm API istekleri SSL/TLS 1.3 üzerinden şifrelenir. Webhook bildirimleri yanıtsız kalırsa sistemimiz 5 dakika aralıklarla 3 kez yeniden deneme (retry) politikası uygular. İdempotency desteği sayesinde çift sipariş onayı riski önlenir.