Naar de inhoud gaan
RemindCash

Betaling volgen

Registreer betalingen die uw klant heeft gemeld, en pauzeer, hervat of annuleer herinneringen voor een te ontvangen.

Openbare API-status

De v1 API maakt gebruik van company-scoped toonder keys en vereist een actieve planning periode. Ontwerp en betaling rapportage eindpunten niet verzenden klantenberichten. Voorbeelden gebruiken plaatshouders .Plakken nooit een echte sleutel in gedeelde code.

RemindCash verwerkt geen betalingen. Wanneer uw klant u betaalt, neemt u deze op zodat herinneringen het resterende bedrag gebruiken of stoppen zodra het volledig is betaald.

Een betaling registreren

POST /v1/receivables/{id}/payments registreert een gerapporteerde betaling. Het heeft de receivables:write scope en een Idempotency-Key.

Veld Vereist Regels
amount Ja. Positieve decimale tekenreeks, tot twee decimalen.
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 toont de status van de schuldvordering na de betaling: voor een actieve schuldvordering wordt het partially_paid, en paid zodra er niets meer over is. Een betaalde schuldvordering ontvangt geen verdere herinneringen.

Pauze, hervatten en annuleren

Methode Pad Toegestaan van
POST /v1/receivables/{id}/pause active, partially_paid
POST /v1/receivables/{id}/resume paused (toen het werd gepauzeerd van actieve of gedeeltelijk betaalde)
POST /v1/receivables/{id}/cancel draft, active, paused, partially_paid, disputed

Elk verzoek heeft een reason nodig tussen 10 en 500 tekens en een Idempotency-Key. De reden wordt opgeslagen in de auditgeschiedenis van de te ontvangen waarde.

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"
    }
}

Voor het hernemen is ook een geverifieerd, in aanmerking komend klantcontact en een resterende saldo vereist. Een wijziging die niet is toegestaan van de huidige status geeft 422 validation_failed terug met een action veldfout. Herinner stappen die werden overgeslagen tijdens de pauze.