Passer au contenu

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.
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 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.

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

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.