Suivi des paiements
Enregistrez les paiements déclarés par votre client, et arrêtez, reprenez ou annulez les rappels pour une créance.
État public de l'API
L'API v1 utilise les clés porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte- porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte-porte--porte-------porte------pere-pere.
RemindCash ne traite pas les paiements. Lorsque votre client vous paie, enregistrez-le afin que les rappels utilisent le montant restant — ou arrêtez-le une fois qu'il est entièrement payé.
Inscrire un paiement
POST /v1/receivables/{id}/payments enregistre un paiement déclaré. Il a besoin de la portée receivables:write et d'un Idempotency-Key.
| Champ | Requis | Règles |
|---|---|---|
amount |
Oui | Chaîne décimale positive, jusqu'à deux décimales. |
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" }'{
"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 indique l'état de la créance après le paiement : pour une créance active, elle devient partially_paid, et paid une fois que rien ne reste.
Pause, reprise et annulation
| Méthode | Voie | Autorisés à partir |
|---|---|---|
POST |
/v1/receivables/{id}/pause |
active, partially_paid |
POST |
/v1/receivables/{id}/resume |
paused (quand il a été arrêté d'actif ou partiellement payé) |
POST |
/v1/receivables/{id}/cancel |
draft, active, paused, partially_paid, disputed |
Chaque demande a besoin d'un reason entre 10 et 500 caractères et d'un Idempotency-Key. La raison est stockée dans l'historique de vérification de la créance.
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." }'{
"data": {
"id": 1,
"status": "paused",
"paid_minor": 0,
"version": "049a6c669d9211215001be5a324c3f5c9e057797ef4d89e21c8aa632578a87ae"
}
}La reprise nécessite également un contact client vérifié et admissible et un solde restant. Un changement qui n'est pas autorisé à partir du statut actuel renvoie 422 validation_failed avec une erreur de champ action. des marches de rappel qui ont été sautées pendant la pause.