À propos de Split Capture
Capturer différentes parties d'une commande multi-articles à différents moments.
Aperçu
Avec Split Capture, vous pouvez collecter ou « capturer » des fonds à la caisse pour des articles individuels au fur et à mesure de leur expédition. Cela facilite la comptabilisation des revenus aux moments appropriés pour votre transaction Affirm.
Fonctionnement de Split Capture
Comprendre le fonctionnement de Split Capture vous aidera à mettre en œuvre une structure de paiement simple pour traiter progressivement les commandes contenant plusieurs articles qui ne peuvent pas être expédiés en même temps. Vous trouverez les détails suivants dans ce guide :
- Autorisation
- Captures multiples
- Traitement des remboursements partiellement saisis
- Annulations partielles
- Idempotence
Autorisation
Au début du prêt, vous utiliserez l'API Transaction pour envoyer une seule demande d'autorisation, qui autorisera la totalité du prêt. Cela crée une fenêtre d'autorisation pour capturer des fonds par incréments que vous contrôlerez ultérieurement.
Fenêtre d'autorisation
La fenêtre d'autorisation est définie comme le nombre de jours dont vous disposez pour capturer des fonds.
Expiration de l'autorisation
Capture requests
ne sera approuvée que pendant la période d’autorisation. Une fois la période d’autorisation écoulée, nous annulerons tous les fonds non perçus et les retournerons au client. Vous recevrez un courriel 7 jours avant la date d’expiration de l’autorisation avec une liste des prêts proches de l’expiration et des prêts avec des fonds non collectés.
Captures multiples
Vous pouvez lancer plusieurs demandes Capture
au cours d'une fenêtre d'autorisation donnée. Après avoir autorisé le montant total de l’achat, vous utiliserez le Capture API pour nous transmettre les fonds spécifiés à capturer dans le paramètre amount
. Vous pouvez envoyer des demandes Capture
autant de fois que nécessaire dans la période d'autorisation tant que le total saisi ne dépasse pas le montant autorisé.
Traitement des erreurs
Nous avons créé une structure robuste pour Split Capture qui prend en charge les éléments suivants :
- La possibilité de passer plusieurs appels de capture sans générer d'erreurs
- Points de contrôle établis pour identifier les requêtes potentielles en double
- Idempotence, qui est expliquée plus en détail ici
Traitement des remboursements partiellement saisis
Les remboursements fonctionnent de la même manière que notre intégration Direct API standard et vous pouvez les traiter à l'aide de l'API Refund. Si vous avez déjà expédié un article et saisi les fonds, effectuez un remboursement pour le montant capturé et nous créditerons ces fonds sur le prêt.
Remboursement des fonds collectés
- Une fois que vous avez remboursé un montant, vous ne pouvez plus le saisir.
- Si le prêt est dans le statut
Captured
et que vous ne passezamount
, l'intégralité du prêt sera remboursée.
Annulations partielles
Lorsque vous lancez des demandes Split Capture et que vous savez qu'un montant spécifique ne sera pas saisi avant l'expiration de l'autorisation, appelez le point de terminaison Void pour le montant spécifié des fonds qui ne seront pas capturés. Après avoir créé une annulation, nous créditerons le montant spécifié au prêt du client.
Notes complémentaires
- Les annulations peuvent être complétées à tout moment pendant la période d’autorisation s’il y a un solde autorisé mais non saisi sur le prêt.
- Si vous ne transmettez pas de montant dans la requête
Void
, le montant actuellement autorisé sera annulé. Cela ne s’applique que si la commande entière est annulée et le montant total du prêt est dans un statutAuthorized
.
Idempotence
L'API Split Capture prend en charge l'idempotence en utilisant des clés d'idempotence qui effectuent plusieurs appels au même point de terminaison sans générer d’erreur. Les clés d'idempotence sont des identifiants uniques pré-générés par le client et utilisés par le serveur pour reconnaître les appels successifs au même point de terminaison; ces clés sont requises pour utiliser l'API Split Capture. Cette fonction est utile lorsque l'on utilise Split Capture et que l'on doit répéter les demandes, ou si le client ne reçoit pas de réponse satisfaisante et que l'on doit réessayer la demande. Par exemple, si vous lancez une requête Capture Transaction et que vous ne recevez pas de réponse, vous pouvez utiliser la même clé d'idempotence unique pour réessayer la demande et vous assurer qu'elle ne sera pas interprétée comme un doublon.
Pour effectuer une requête idempotente, ajoutez un en-tête Idempotency-Key
à la requête. La valeur clé doit être suffisamment unique pour identifier positivement une opération que vous avez initiée au cours des 30 derniers jours. La idempotence des fonctions Split Capture en stockant la réponse et le code de statut de la demande initiale envoyée pour une clé d’idempotence donnée. Les demandes ultérieures utilisant la même clé donneront lieu à la même réponse de succès ou d'échec.
Mis à jour il y a environ 1 an