Link Yönetimi
{id}, link oluşturma cevabındaki id değeridir. Tüm isteklerde Authorization ve X-External-Merchant-Id başlıkları gönderilir.
| İşlem | İstek | Başarılı cevap |
|---|---|---|
| Mağaza linklerini listele | GET /api/v1/payment-links?magaza=true&page=1&page_size=20 | 200, sayfalı liste |
| Tek link | GET /api/v1/payment-links/{id} | 200, link |
| Güncelle | PUT /api/v1/payment-links/{id} | 200, güncel link |
| Pasife al | POST /api/v1/payment-links/{id}/deactivate | 204, gövde yok |
| Yeniden aç | POST /api/v1/payment-links/{id}/activate | 204, gövde yok |
| Sil | DELETE /api/v1/payment-links/{id} | 204, gövde yok |
| Özet | GET /api/v1/payment-links/{id}/summary | 200 |
| Ürün güncelle | PUT /api/v1/products/{product_id} | 200, güncel ürün |
| Ürün sil | DELETE /api/v1/products/{product_id} | 204, gövde yok |
Listeleme
curl "$API_URL/api/v1/payment-links?magaza=true&page=1&page_size=20" \
-H "Authorization: Bearer $TOKEN" \
-H "X-External-Merchant-Id: $MERCHANT_NO"{
"items": [ { "id": "...", "slug": "...", "title": "...", "is_active": true } ],
"page": 1,
"total_pages": 1,
"total_count": 18,
"has_previous_page": false,
"has_next_page": false
}Güncelleme
Güncelleme tam değiştirmedir
Oluşturmadaki gövdenin tamamı gönderilir. Gönderilmeyen alanlar (expires_at, success_url, max_uses vb.) boşaltılır. Linkin adresi değişmesin diye slug aynı verilmelidir.
curl -X PUT "$API_URL/api/v1/payment-links/{id}" \
-H "Authorization: Bearer $TOKEN" \
-H "X-External-Merchant-Id: $MERCHANT_NO" \
-H "Content-Type: application/json" \
-d '{
"title": "Kasım ayı aidat ödemesi",
"slug": "48ht6vcbwl",
"description": null,
"amount_mode": "fixed",
"fixed_amount": 175000,
"currency": "TRY",
"installments_disabled": false,
"payment_mode": "three_d_secure",
"allow_pre_auth": false,
"collect_email": true,
"collect_phone": true,
"collect_billing_address": false,
"collect_shipping_address": false,
"collect_invoice_details": false,
"require_terms_acceptance": true,
"allow_promotion_codes": false,
"metadata": {
"magaza.page": "storefront",
"magaza.product_type": "collection",
"magaza.display_name": "Örnek İşletme",
"magaza.collect_buyer_details": "true"
}
}'Fiziksel/Dijital linkte fiyat değişecekse ürünü güncellemeniz yeterlidir (PUT /api/v1/products/{product_id}, oluşturmadaki gövdenin tamamıyla); yeni fiyat linke hemen yansır. Link başlığı (title) linkte ayrıca güncellenir.
Silme
Silinen link açılmaz; GET isteği 404 resource_not_found döner.
Bir ürün, bağlı olduğu link silinmeden silinemez (409 PV_PRODUCT_IN_USE_BY_PAYMENT_LINK). Sıra:
DELETE /api/v1/payment-links/{id}DELETE /api/v1/products/{product_id}
Özet
curl "$API_URL/api/v1/payment-links/{id}/summary" \
-H "Authorization: Bearer $TOKEN" \
-H "X-External-Merchant-Id: $MERCHANT_NO"{
"view_count": 0,
"checkout_start_count": 0,
"payment_count": 0,
"gross_amount": 0,
"failed_count": 0,
"not_completed_count": 0,
"last_payment_at": null,
"currency": "TRY"
}| Alan | Açıklama |
|---|---|
view_count | Ödeme sayfasının açılma sayısı |
checkout_start_count | Ödeme adımına geçilme sayısı. Sayfanın yalnız açılması sayılmaz; işlemle sonuçlanmayan denemeler de sayılır |
payment_count | Başarılı (completed) ödeme sayısı |
gross_amount | Başarılı ödemelerin toplamı, kuruş |
failed_count | Reddedilen (failed) ödeme sayısı |
not_completed_count | 3D Secure adımında tamamlanmayan (not_completed) ödeme sayısı |
last_payment_at | Son başarılı ödemenin zamanı; ödeme yoksa null |
currency | TRY |
Linkin Durumu (Kimlik Doğrulamasız)
Linkin ve ürünün durumunu token olmadan sorgulayabilirsiniz:
curl "$API_URL/api/v1/checkout/links/{slug}"| Alan | Anlamı |
|---|---|
is_active | Link açık mı |
is_expired | expires_at geçti mi |
is_exhausted | max_uses doldu mu |
products[].is_out_of_stock | Ürün stoğu bitti mi. Stok bitince link açık kalır, ürün satılamaz |
products[].stock_quantity | Kalan ürün stoğu |
Silinmiş link için 404 döner.

