Linkleri Yönetme

Oluşturduğunuz linkleri bu sayfadaki uçlarla yönetirsiniz. Bütün uçlar Link Oluşturma sayfasında anlatılan imzalı istek ile çağrılır ve anahtarınızın ilgili payment-link:* yetkisini ister. Bir anahtar yalnız kendi ortamındaki (TEST ya da LIVE) linkleri görür; başka bir organizasyonun ya da diğer ortamın linki 404 döner. Aynı işlemleri panelden de yapabilirsiniz.

Node.js örnekleri Link Oluşturma sayfasındaki signedHeaders yardımcısını kullanır. cURL örnekleri aynı imzalama adımlarının kabuk fonksiyonu hâlini kullanır:

# lunixi-sign.sh — OpenSSL 3.0+ gerekir.
# Kullanım: source lunixi-sign.sh
#           lunixi_sign GET  "/api/v1/payments/links?limit=25"
#           lunixi_sign POST "/api/v1/payments/links/<id>/pause" "$BODY"
LUNIXI_KEY_ID="mk_test_sk_..."
LUNIXI_KEY_FILE="lunixi-signing.key"
 
lunixi_sign() {
  local method="$1" req_path="$2" body="${3-}"
  DATE=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
  NONCE=$(openssl rand -hex 16)
  if [ -n "$body" ]; then
    DIGEST="SHA-256=$(printf '%s' "$body" | openssl dgst -sha256 -binary | base64)"
    printf '%s\n%s\nX-Date:%s\nX-Nonce:%s\nDigest:%s' "$method" "$req_path" "$DATE" "$NONCE" "$DIGEST" > canonical.txt
  else
    DIGEST=""
    printf '%s\n%s\nX-Date:%s\nX-Nonce:%s' "$method" "$req_path" "$DATE" "$NONCE" > canonical.txt
  fi
  SIGNATURE=$(openssl pkeyutl -sign -inkey "$LUNIXI_KEY_FILE" -rawin -in canonical.txt | base64 | tr -d '\n')
}

Listeleme

GET /api/v1/payments/links linklerinizi en yeniden eskiye, cursor tabanlı sayfalar hâlinde döner.

source lunixi-sign.sh
REQ_PATH="/api/v1/payments/links?limit=25&state=ACTIVE,PAUSED"
lunixi_sign GET "$REQ_PATH"
 
curl "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"

Yanıt

pageInfo, data'nın yanındadır; liste data.items içindedir.

{
  "status": "success",
  "code": "SUCCESS",
  "data": {
    "items": [
      {
        "id": "5f0c1d2e-8a4b-4c6d-9e7f-1a2b3c4d5e6f",
        "shortCode": "7KQ2M9XAPT",
        "url": "https://pay.lunixi.com/7KQ2M9XAPT",
        "organizationId": "b1d2c3e4-…",
        "environment": "TEST",
        "state": "ACTIVE",
        "usage": "SINGLE_USE",
        "amountMode": "FIXED",
        "currency": "TRY",
        "amountMinor": 150000,
        "title": "Kasım danışmanlık bedeli",
        "reference": "INV-2026-0042",
        "tags": [],
        "paidCount": 0,
        "collectedAmountMinor": 0,
        "expiresAt": "2026-10-31T20:59:59.000Z",
        "createdByType": "API_KEY",
        "createdById": "mk_test_sk_…",
        "createdAt": "2026-09-25T09:00:00.000Z",
        "version": 1,
        "rowVersion": 1
      }
    ]
  },
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": null },
  "statusCode": 200,
  "requestId": "req_7f3d9c1a4b2e"
}

Liste satırı özettir; amountMinor yalnız FIXED linklerde doludur. Tam kayıt için GET /api/v1/payments/links/:id çağırın.

Tek link

GET /api/v1/payments/links/:id linkin tam kaydını döner: bütün alanlar, recipient ve prefill dahil, sayaçlar (counters), stok durumu (availability) ve kilit bayrakları. Yanıt şekli oluşturma yanıtıyla aynıdır — bkz. Link Oluşturma › Yanıt.

Güncelleme

PATCH /api/v1/payments/links/:id linkin tanımını değiştirir ve yeni bir sürüm (version) üretir. Süren ödemeler başladıkları sürümün tutar ve kurallarıyla tamamlanır.

Başlık, açıklama, bitiş zamanı, alıcı alanları ve atıf alanları gibi tutar dışı alanlar tutar kilidine tabi değildir. Başarılı güncelleme payment.link.updated yayınlar.

source lunixi-sign.sh
LINK_ID="5f0c1d2e-8a4b-4c6d-9e7f-1a2b3c4d5e6f"
REQ_PATH="/api/v1/payments/links/$LINK_ID"
BODY='{"expectedRowVersion":1,"title":"Kasım danışmanlık bedeli (revize)","expiresAt":"2026-11-15T20:59:59.000Z"}'
lunixi_sign PATCH "$REQ_PATH" "$BODY"
 
curl -X PATCH "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "Content-Type: application/json" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "Digest: $DIGEST" \
  -H "X-Signature: $SIGNATURE" \
  --data-raw "$BODY"

Duraklatma, devam ettirme ve iptal

POST /api/v1/payments/links/:id/pause, /resume ve /deactivate linkin durumunu değiştirir ve güncel linki döner.

Geçersiz geçiş (ör. COMPLETED bir linki duraklatmak) 409 payment_link.link.invalid_transition döner.

source lunixi-sign.sh
REQ_PATH="/api/v1/payments/links/$LINK_ID/pause"
BODY='{"expectedRowVersion":2,"reason":"Stok sayımı"}'
lunixi_sign POST "$REQ_PATH" "$BODY"
 
curl -X POST "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "Content-Type: application/json" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" -H "X-Date: $DATE" -H "X-Nonce: $NONCE" \
  -H "Digest: $DIGEST" -H "X-Signature: $SIGNATURE" \
  --data-raw "$BODY"

Gönderme

POST /api/v1/payments/links/:id/send linki Lunixi üzerinden e-posta ya da SMS ile gönderir. Idempotency-Key zorunludur: aynı anahtarla tekrar isteği yeni bir gönderim yapmaz, ilk gönderimi replayed: true ile döner; aynı anahtar farklı gövdeyle 409 payment_link.idempotency.conflict alır.

{
  "status": "success",
  "code": "SUCCESS",
  "data": {
    "delivery": {
      "id": "0e8a7c55-…",
      "kind": "REQUEST",
      "channel": "EMAIL",
      "recipientMasked": "a***@example.com",
      "state": "QUEUED",
      "failureReason": null,
      "attemptId": null,
      "createdAt": "2026-09-25T09:05:00.000Z",
      "updatedAt": "2026-09-25T09:05:00.000Z"
    },
    "replayed": false
  },
  "statusCode": 200,
  "requestId": "req_…"
}

Gönderim QUEUED olarak kaydedilir ya da hemen FAILED döner. Sonraki durum değişiklikleri (SENT, DELIVERED, FAILED) panelde linkin gönderim geçmişinde görünür.

• Kaldırılmış linkte gönderim 409 payment_link.link.taken_down döner.
• Gönderim, linkin erişim doğrulaması kilidini de açar (verificationLocked: false): alıcı çok fazla hatalı kod girdiyse yeni kod isteyebilmesi için linki yeniden gönderin.
• Hatırlatmalar (reminders) ayrı bir çağrı gerektirmez; recipient dolu tek kullanımlık linkte tanımladığınız aralıkla gönderilir.

QR kodu

GET /api/v1/payments/links/:id/qr linkin adresini (https://pay.lunixi.com/<KOD>) içeren QR kodunu görsel olarak döner — JSON değil.

Yanıt Content-Type: image/svg+xml ya da image/png ve Cache-Control: no-store taşır. Hata durumunda standart JSON hata zarfı döner. Kaldırılmış linkte 409 payment_link.link.taken_down.

source lunixi-sign.sh
REQ_PATH="/api/v1/payments/links/$LINK_ID/qr?format=png&size=1024"
lunixi_sign GET "$REQ_PATH"
 
curl "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" -H "X-Date: $DATE" -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE" \
  -o link-qr.png

Ödeme denemeleri

GET /api/v1/payments/links/:id/attempts linkte başlatılan her ödeme denemesini en yeniden eskiye döner. Parametreler: limit, cursor ve virgülle ayrılmış state.

Deneme kayıtları alıcının kişisel verilerini içerir; kendi sistemlerinizde buna göre saklayın.

Tahsilatlar

GET /api/v1/payments/links/:id/payments linkin başarılı ödemelerini iade toplamlarıyla birlikte döner. Parametreler: limit, cursor.

İade için mevcut İade ucunu paymentId ile kullanın. İade linkin durumunu değiştirmez: tek kullanımlık link COMPLETED kalır, çok kullanımlık linkte satılan stok geri eklenmez.

Hatalar

İmza hataları (401) için: Link Oluşturma › Hatalar. 5xx yanıtlarında isteği üstel geri çekilmeyle yeniden deneyin; send çağrısını aynı Idempotency-Key ile tekrarlarsanız ikinci bir gönderim yapılmaz.

Sonraki adımlar

• Ödeme Sayfası — alıcının gördüğü sayfa ve erişim doğrulaması
• Webhook'lar — link event'leri ve siparişi teslim etme
• Sayfalama — limit + cursor standardı