Payment Links

Müşterilerinin ödeme yapabileceği paylaşılabilir linkler oluştur ve listele.

Link oluştur

Gövde parametreleri:

description   string   (zorunlu)  Linkin açıklaması
amount        integer  (zorunlu)  Tutar, minor units (1990 = $19.90)
currency      string   (ops.)     Varsayılan: platform para birimi
type          string   (ops.)     "one_time" (varsayılan) | "subscription"
interval      string   (ops.)     subscription için: "month" | "year"
success_url   string   (ops.)     Başarılı ödeme sonrası müşterinin döneceği URL
cancel_url    string   (ops.)     İptal / başarısız ödeme sonrası dönülecek URL
items         array    (ops.)     [{ name, price, qty }] satır kalemleri

Aylık tekrarlayan ödemeler için type: "subscription" kullan — ayrıntılar Subscriptions sayfasında.

curl -X POST http://localhost:3000/api/v1/payment-links \
  -H "Authorization: Bearer mm_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "description": "Pro Plan", "amount": 1990 }'

Yanıt (201):

{
  "id": "clx...",
  "url": "http://localhost:3000/pay/a1b2c3...",
  "description": "Pro Plan",
  "amount": 1990,
  "currency": "usd",
  "status": "active"
}

Ödeme Sonrası Yönlendirme (Sanal POS)

success_urlverirsen, müşteri ödemeyi tamamlayınca otomatik olarak kendi sitene döner. URL'ine durum parametreleri eklenir:

https://siteniz.com/odeme/basarili?status=success&payment_intent=pi_3Q...
# abonelikte:  ?status=success&subscription=sub_1Q...
# başarısızsa cancel_url'e:  ?status=failed&payment_intent=pi_3Q...

Linkleri listele

curl http://localhost:3000/api/v1/payment-links \
  -H "Authorization: Bearer mm_live_xxx"

{
  "object": "list",
  "data": [
    { "id": "clx...", "url": "...", "amount": 1990, "currency": "usd", "status": "active", "created": 1750000000 }
  ]
}