Plan Güncelle

POST/partner/1.0/recurring/update
Gerekli scope: payment:sale

Tutar (sonraki ödemelerden itibaren), açıklama, hatırlatma ve iletişim tercihleri değiştirilebilir. Periyot ve başlangıç tarihi değişmez — farklı periyot yeni plan gerektirir.

Örnek

curl -X POST https://<host>/partner/1.0/recurring/update \
  -H "X-Api-Key: ..." \
  -H "X-Timestamp: ..." \
  -H "X-Signature: ..." \
  -H "Content-Type: application/json" \
  -d '{
  "id": "REC-3301",
  "amount": 179.9,
  "description": "Aylık üyelik (yeni fiyat)"
}'

İstek Body

AlanTipAçıklama
idzorunlustringPlan kimliği.
amountdecimalYeni dönem tutarı. 0'dan büyük olmalıdır; sonraki tahsilatlara uygulanır.
descriptionstringYeni açıklama.
reminderDaysBeforeintegerHatırlatma gün sayısı.
enableEmailReminderbooleanE-posta hatırlatması.
enableSmsReminderbooleanSMS hatırlatması.
enablePushReminderbooleanPush hatırlatması.
emailstringAbone e-posta adresi.
phoneCountryCodestringAbone telefon ülke kodu.
phoneNumberstringAbone telefon numarası.

Yanıt

AlanAnlamı
idPlan kimliği. detail / update / pause / resume / cancel bu değeri alır.
referenceNumberSistem üretimli referans numarası.
orderNumberSizin gönderdiğiniz sipariş/sözleşme numaranız; plandan doğan tüm tahsilatlara taşınır.
amount / currencyDönem başına tahsil edilecek tutar ve para birimi.
descriptionAbonenin ekstresinde görünecek açıklama.
statusPlan durumu (ACTIVE, PAUSED, CANCELLED, COMPLETED, EXPIRED). Başarısız deneme sayısı maxFailedRetries'a ulaşınca plan kendiliğinden PAUSED olur.
interval / intervalValuePeriyot birimi ve kaç periyotta bir çekileceği.
totalInstallmentCount / paidInstallmentCountToplam ve tahsil edilmiş dönem adedi.
failedRetryCountArt arda başarısız denemelerin sayacı; başarılı tahsilatta sıfırlanır.
email / phoneCountryCode / phoneNumberAbone iletişim bilgileri.
startDate / expiryDateİlk tahsilat ve plan bitiş tarihi.
nextPaymentDate / lastPaymentDateSıradaki ve son tahsilat tarihi.
createdDatePlanın kurulma tarihi.

Hatalar

Mesaj anahtarıHTTPNeden
id.empty400id boş gönderildi.
amount.must.greater.than.0400amount gönderildi ama 0'dan büyük değil.
invalid.status.transition406COMPLETED ya da CANCELLED plan güncellenemez.
checkoutrecurring.not.found404Bu kimlikle bir plan yok. Plan başka bir işletmeye aitse aynı anahtar 403 ile döner.

İsteği Dene

İsteği Dene
Önizleme modu — değerler kod örneklerini günceller, gerçek istek atılmaz.
Mock