İçeriğe geç
RemindCash

Hatırlatmalar

Hatırlatma planlarının nasıl çalıştığı ve bir alacak için yapılan hatırlatma denemelerinin nasıl okunacağı.

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.

Hatırlatmalar nasıl planlanır

Her etkin alacak şirketin hatırlatma planını izler. Varsayılan plan vade tarihinden 3 gün önce, vade gününde ve 3 gün sonra gönderir; şirketler uygulamada adım ekleyebilir, kaldırabilir veya taşıyabilir. Hatırlatmalar şirketin izin verdiği saatlerde gönderilir (varsayılan olarak yerel saatle 09:00–18:00, hafta sonları kapalı) ve iki kez gönderilmek yerine bir sonraki uygun zamana kaydırılır.

Alacak ödendiğinde, duraklatıldığında, itiraz edildiğinde veya iptal edildiğinde ve müşteri aboneliği bıraktığında hatırlatmalar durur.

Hatırlatma denemelerini listeleme

GET /v1/reminder-attempts, bir alacağın gönderim denemelerini en yeniden eskiye doğru döndürür. receivables:read kapsamı gerektirir.

Sorgu parametresi Zorunlu Açıklama
receivable_id Evet İncelenecek alacak.
per_page Hayır 1–100, varsayılan 25.
BASH
curl "https://api.remindcash.com/v1/reminder-attempts?receivable_id=1" \
  --header "Authorization: Bearer $REMINDCASH_API_KEY"
JSON
{
    "data": [],
    "meta": { "current_page": 1, "per_page": 25, "total": 0 },
    "request_id": "8cfc4494-5a40-4bd9-aa9b-5d5716840140"
}

Deneme nesnesi

Alan Açıklama
id Deneme kimliği.
attempt_no O hatırlatma adımı için deneme numarası.
stage_key Denemenin planın hangi adımına ait olduğu.
channel Mesaj kanalı, örneğin email.
provider_state İç gönderim durumu: prepared, claimed, sending, accepted, rejected, unknown veya cancelled.
delivery_status Normalleştirilmiş e-posta durumu: queued, sending, accepted, delivered, bounced, failed, unknown veya cancelled. Mevcut değilse null.
submitted_at Mesajın sağlayıcıya teslim edildiği an (UTC) veya null.
resolved_at Sonucun kesinleştiği an (UTC) veya null.

Gönderim durumlarını doğru okumak

  • accepted, sağlayıcının mesajı kabul ettiği anlamına gelir — teslim edildiği veya okunduğu anlamına gelmez.
  • delivered yalnızca sağlayıcı teslimatı bildirdiğinde gösterilir.
  • unknown, sağlayıcının net yanıt vermediği anlamına gelir (örneğin zaman aşımı). İki kez göndermemek için RemindCash bu durumda otomatik olarak yeniden denemez; deneme mutabakat yapılana kadar unknown kalır.
  • Teslim edilen bir hatırlatma alacağı asla ödendi yapmaz.