Utilisez des postes de paiement pour des paiements flexiblesVersion bêta publique

Vous pouvez utiliser des postes de paiement pour les paiements complexes tels que les paiements multicaptures et surcaptures.

Multicapture

Vous pouvez utiliser des postes de paiement lors de multicaptures.

Créer et confirmer un PaymentIntent non capturé

Spécifiez capture_method comme manual lors de la création du PaymentIntent et utilisez le paramètre if_available pour demander la multicapture pour ce paiement. Le PaymentIntent créé permet des captures multiples si le moyen de paiement le permet.

Dans la réponse, le champ amount_details contient les postes spécifiés dans le PaymentIntent.

Capturer le PaymentIntent

• Vous pouvez ajouter amount_details lors de la première capture même s’ils n’ont pas été spécifiés lors de la création.
• Si vous avez fourni amount_details lors de la création, vous devez soit passer amount_details, soit les désactiver lors de la première capture.

Les mêmes règles s’appliquent à amount_details[line_items] : vous pouvez les ajouter lors de la première capture s’ils n’ont pas été spécifiés lors de la création, mais vous devez les inclure ou les désactiver explicitement s’ils étaient présents lors de la création.

Dans la réponse, le champ amount_details contient les postes spécifiés lors de la première capture.

Le PaymentIntent reste dans l’état requires_capture. À ce stade :

• Continuez à capturer le PaymentIntent plusieurs fois jusqu’à ce que le montant total du PaymentIntent soit atteint.
• Faites passer le PaymentIntent à l’état succeeded en réglant final_capture sur true, ou en effectuant une capture sans le paramètre final_capture (parce que final_capture est réglé par défaut sur true).

Surcapture

Vous pouvez utiliser des postes de paiement lors de surcaptures.

Créer et confirmer un PaymentIntent non capturé

Spécifiez le paramètre capture_method comme manual lors de la création du PaymentIntent et utilisez le paramètre if_available pour demander une surcapture pour ce paiement. Le PaymentIntent créé autorise la surcapture si le moyen de paiement le permet.

Dans la réponse, le champ amount_details contient les postes spécifiés dans le PaymentIntent.

Capturer le PaymentIntent

Pour capturer un montant supérieur au montant actuellement autorisé sur un PaymentIntent, utilisez l’endpoint de capture et indiquez un amount_to_capture jusqu’au maximum_amount_capturable.

Transmettez un hachage amount_details mis à jour qui correspond au montant de la capture lors de la capture.

Dans la réponse, le champ amount_details contient les postes spécifiés lors de la capture.

Autorisation complémentaire

Vous pouvez utiliser des postes de paiement pendant l’autorisation complémentaire pour autoriser des montants supplémentaires sur un PaymentIntent après l’autorisation initiale.

Créer et confirmer un PaymentIntent non capturé

Spécifiez le paramètre capture_method comme manual lors de la création du PaymentIntent et utilisez le paramètre if_available pour requérir une autorisation complémentaire pour ce paiement. Le PaymentIntent créé accepte l’autorisation complémentaire si le moyen de paiement le prend en charge.

Dans la réponse, le champ amount_details contient les postes spécifiés dans le PaymentIntent.

Incrémenter l’autorisation

Pour autoriser des montants supplémentaires sur un PaymentIntent au-delà du montant initialement autorisé, utilisez l’endpoint increment_authorization et fournissez un montant jusqu’au montant d’autorisation complémentaire maximum pris en charge par le moyen de paiement.

Transmettez un hachage amount_details mis à jour qui correspond au montant total autorisé après l’autorisation complémentaire.

Dans la réponse, le champ amount_details contient les éléments de poste spécifiés lors de l’autorisation complémentaire, et le montant total autorisé du PaymentIntent est mis à jour.