İçeriğe geç

Tekrarlayan alacaklar

Haftalık ve aylık tekrarlayan alacakların nasıl çalıştığı ve v1 API’nin bunlarla neler yapıp yapamadığı.

Herkese açık API durumu

Burada anlatılan v1 API uygulanmış ve test edilmiştir, ancak api.remindcash.com henüz herkese açık değildir. Son kabul testlerinden sonra açılacak; o zamana kadar istekler 503 döner. Örneklerde yer tutucular kullanılır — gerçek bir anahtarı asla paylaşılan koda yapıştırmayın.

Henüz API’de yok. Tekrarlayan seriler RemindCash uygulamasında oluşturulur ve yönetilir. v1 API’de seri oluşturma, düzenleme veya durdurma uç noktası yoktur.

Tekrarlayan alacaklar nasıl çalışır

Tekrarlayan alacak, süresiz ya da durdurulana kadar haftalık veya aylık tekrarlanan bir seridir. Her tekrar ayrı bir dönemdir ve şunlara sahiptir:

  • kendi kalıcı kimliği, vade tarihi ve tutar anlık görüntüsü,
  • kendi hatırlatma planı ve ödeme durumu.

Bir dönemin ödenmesi başka bir dönemi asla ödendi yapmaz ve ödenmiş bir dönem için bir daha hatırlatma yapılmaz. Daha kısa bir ayda bulunmayan aylık tarihler tutarlı bir ay sonu kuralını izler.

Bir seriyi uygulamada düzenlediğinizde değişikliğin yalnızca bu döneme mi yoksa gelecek dönemlere mi uygulanacağını seçersiniz. Geçmiş ve ödenmiş dönemler asla yeniden yazılmaz.

API ile yapabilecekleriniz

  • Dönemler, diğer alacaklar gibi kendi id, due_date ve status değerleriyle GET /v1/receivables yanıtında görünür.
  • Bir döneme ödeme kaydedebilir, onu duraklatabilir, sürdürebilir veya iptal edebilirsiniz.
  • Bir dönem üzerinde PATCH 409 conflict döndürür — bunun yerine seriyi uygulamada düzenleyin.