New management of unpaid subscription installments

New management of unpaid subscription installments

Until now, unpaid subscription installments did not generate any invoice. Starting from version 1.7, each...

Catching up your database upon your site update

When your site was updated with this new behavior, in order to maintain consistency in your database between your existing subscriptions and future ones, a program created all "missing" installments, even when the subscriptions are associated with a completed rental.

Example: you have a subscription in dispute since 01/09/2023. Your site was updated with the feature on 10/02/2024. => Upon restart, we automatically generated the installment lines and corresponding invoices for the months of September, October, November, December, January, and February 2024.

The error displayed on these installments will be: Auto-generated transaction (without PSP call). This means that we recorded these installments under the same error as the last unpaid installment, rather than attempting to charge your PSP.

Example: the last unpaid installment was due to a card flagged as stolen by the PSP in September — all installments from October to February will also be recorded with this same error, without us actually attempting to charge them.

Why does the catch-up not include an attempt to charge the outstanding installments?

1° In order to avoid failed transaction fees with your PSP. 2° It would be problematic to charge your customers several overdue installments at once.

The new unpaid installment in the Subscriptions menu

Previously, when a subscription ended up in DISPUTE status, our system no longer took any action on that subscription and did not generate an invoice for the unpaid installment.

From now on:

1° An unpaid installment has an invoice marked as UNPAID. You will ultimately be able to download the invoice for the installment, despite its payment failure. 2° Even if the previous installment's charge did not go through and the subscription is in dispute, a new installment will be generated each month and will indeed create an associated invoice, as long as the rental has not ended.

Example: It is 10/08/2024 and you have a subscription in dispute since 10/03/2024. => You will have in the subscription's payment schedule a failed installment for March, April, May, June, July, and August, with an UNPAID invoice for each installment.

After an unpaid installment, the new installment can be created in two different ways:

A) If the previous installment was in fatal error

The rebill batch will create the installment line as unpaid by default, without calling your PSP, since we already know that the payment card is not working. The error displayed on these installments will be, as with your installments previously caught up in bulk upon the new feature going live: Auto-generated transaction (without PSP call).

B) If the previous installment was in temporary error

The rebill batch will attempt to charge the new installment for the current month.

• If the payment fails with a fatal error, the installment charge will no longer be attempted and the subscription will remain IN DISPUTE.

• If the payment fails with a temporary error, the installment charge will be attempted according to your recurring payment configuration. The subscription will remain in dispute until the charge either succeeds or definitively fails.

• If the payment succeeds, the rebill batch will attempt to charge a second unpaid installment, starting from the oldest unpaid one in the payment schedule.

Example:

It is 09/08/2024 and you have a subscription in dispute since 10/03/2024 due to a temporary error. On 10/08/2024, the rebill batch will attempt to charge the August 2024 installment.

• If the payment fails with a fatal error: no change, the subscription remains in dispute.
• If the payment fails with a temporary error, and you have configured retry attempts every three days, we will retry the charge on 13/08/2024.
• If the payment succeeds, we will attempt on the same day to also charge the installment from 10/03/2024.

The invoice for an unpaid installment

Two specific notes are worth highlighting:

• the "unpaid" mention below the invoice number
• the "amount due" mention at the bottom of the totals block

The unpaid installments export

You can export a .csv listing of your rentals with unpaid installments in order to track their recovery process if necessary.

Fields in the unpaid installments export

The unpaid installments export in .csv format allows you to efficiently track subscription dispute situations.

Here is the detail of the columns present in this file:

• ID LOCATION
• PRÉNOM / NOM / EMAIL / TÉLÉPHONE
• JOURNEY ID (if the Meelo feature is enabled)
• ADRESSE DE LIVRAISON / DE FACTURATION / ADRESSE / CODE POSTAL / VILLE
• DATE DE RÉSERVATION (passage à VALIDÉE)
• DATE DÉBUT LOCATION (remise du produit)
• DATE PASSAGE À RETOURNÉE
• NOM DU PRODUIT / SKU / N° DE SÉRIE / CATÉGORIE(S)
• STATUT DES ARTICLES (en stock, cassé, etc.)
• TYPE DE LIVRAISON (point relais ou domicile)
• CARTE DE PAIEMENT (4 derniers chiffres)
• TOTAL DES IMPAYÉS (affiché en euros)
• TOTAL DES IMPAYÉS (VALEUR) (affiché en chiffre brut)
• NB D'ÉCHÉANCES IMPAYÉES
• NB DE MENSUALITÉS — Total number of installments for the subscription, including the initial payment (installment no. 1)
• N° MENSUALITÉ LORS DE LA RENTRÉE EN IMPAYÉS — Indicates from which installment the subscription entered into arrears (always ≥ 2)
• DATE PREMIÈRE FACTURE IMPAYÉE — Corresponds to the oldest unpaid invoice recorded for this subscription
• DATE DERNIÈRE FACTURE IMPAYÉE
• MOTIF PSP REJET DE LA DERNIÈRE TENTATIVE
• DATE DERNIÈRE TENTATIVE

What should you do to resolve a subscription in dispute?

Refer to this article to see the actions you can take in your back office to resolve a subscription in dispute.