Überspringen zum Inhalt
RemindCash

Zahlungsverfolgung

Zeichnen Sie Zahlungen auf, die Ihr Kunde gemeldet hat, und pausieren, nehmen Sie die Erinnerungen für eine Forderung wieder auf oder stornieren Sie sie.

Public API Status

Die v1-API verwendet unternehmensweit erfasste Trägerschlüssel und erfordert einen aktiven Planzeitraum. Endpunkte für Entwurfs- und Zahlungsberichte senden keine Kundennachrichten. Beispiele verwenden Platzhalter — fügen Sie niemals einen echten Schlüssel in einen freigegebenen Code ein.

RemindCash verarbeitet keine Zahlungen. Wenn Ihr Kunde Sie bezahlt, notieren Sie es, damit Erinnerungen den verbleibenden Betrag verwenden - oder stoppen, sobald er vollständig bezahlt ist.

Aufzeichnung einer Zahlung

POST /v1/receivables/{id}/payments eine gemeldete Zahlung aufzeichnet. receivables:write Anwendungsbereich und ein []Idempotency-Key](/de/docs/pagination-and-idempotency#idempotenz).

Feld erforderlich Vorschriften
amount Ja Positive Dezimalzeichenfolge, bis zu zwei Dezimalstellen.
BASH
curl https://api.remindcash.com/v1/receivables/1/payments \
  --request POST \
  --header "Authorization: Bearer $REMINDCASH_API_KEY" \
  --header "Idempotency-Key: payment-inv-1042-0001" \
  --header "Content-Type: application/json" \
  --data '{ "amount": "250.00" }'
JSON
{
    "data": {
        "id": 1,
        "receivable_id": 1,
        "amount_minor": 25000,
        "remaining_after_minor": 100000,
        "status_after": "draft",
        "recorded_at": "2026-10-11T12:58:05.000000Z"
    }
}

status_after zeigt den Status der Forderung nach der Zahlung an: Für eine aktive Forderung wird es partially_paid und paid, sobald nichts mehr übrig ist.

Pause, Wiederaufnahme und Absage

Methode Wegstrecke Zulässig vom
POST /v1/receivables/{id}/pause active, partially_paid
POST /v1/receivables/{id}/resume paused (wenn es von aktiv oder teilweise bezahlt pausiert wurde)
POST /v1/receivables/{id}/cancel draft, active, paused, partially_paid, disputed

Jede Anfrage benötigt ein reason zwischen 10 und 500 Zeichen und ein Idempotency-Key. Der Grund wird in der Prüfungshistorie der Forderung gespeichert.

BASH
curl https://api.remindcash.com/v1/receivables/1/pause \
  --request POST \
  --header "Authorization: Bearer $REMINDCASH_API_KEY" \
  --header "Idempotency-Key: pause-inv-1042-000001" \
  --header "Content-Type: application/json" \
  --data '{ "reason": "Customer asked for one more week." }'
JSON
{
    "data": {
        "id": 1,
        "status": "paused",
        "paid_minor": 0,
        "version": "049a6c669d9211215001be5a324c3f5c9e057797ef4d89e21c8aa632578a87ae"
    }
}

Eine Änderung, die aus dem aktuellen Status nicht erlaubt ist, gibt 422 validation_failed mit einem action-Feldfehler zurück. Erinnerungsschritte, die während der Pause übersprungen wurden.