À propos de Split Capture

Découvrez comment Split Capture permet aux commerçants de collecter différentes parties d'une commande à plusieurs 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.

Offrez une expérience d'achat agréable et sans stress :

  • Les clients remplissent une demande simple, fournissant quelques renseignements de base pour obtenir une décision en temps réel.
  • Plus de pouvoir d'achat pour vos clients grâce à des options de paiement flexibles.
  • Des options de personnalisation et de marque qui s'intègrent harmonieusement à votre site.
  • Une expérience de transaction transparente et sécurisée pour vous et vos clients.

L'expérience client

Les clients n'ont pas de visibilité sur les transactions Split Capture, car ils effectuent uniquement leurs paiements à Affirm. Une fois qu’un client est approuvé pour un prêt, il peut passer à la caisse avec Affirm. Ils commencent à effectuer des paiements à Affirm selon le plan qu'ils ont choisi.

L’Expérience du Commerçant

Split Capture propose une structure de caisse simple qui vous permet de traiter progressivement les commandes contenant plusieurs articles qui pourraient ne pas être expédiés en même temps.

Lorsqu'une partie d'une commande est expédiée, vous capturez le montant pour la marchandise expédiée et Affirm vous verse le même montant. Lorsque le reste de la commande est expédié et que vous capturez le montant restant, Affirm vous verse le montant restant.

Pour une commande de 1 000 $, le client confirme le prêt, le commerçant autorise le montant total de l'achat, et le prêt est autorisé. Le commerçant expédie une partie de la commande et encaisse 400 $. Affirm verse 400 $ au commerçant. Plus tard, les navires commerçants expédient le reste de la commande et capturent 600 $. Affirm verse 600 $ au commerçant.

Autorisation

Au début du prêt, vous pouvez utiliser l'API de transaction pour envoyer une seule requête Authorization afin d’autoriser la totalité du prêt. Cela crée une fenêtre d'autorisation pour capturer des fonds par incréments que vous pourrez contrôler ultérieurement.

Fenêtre d'autorisation

La fenêtre d'autorisation correspond au nombre de jours dont vous disposez pour capturer des fonds.

Expiration de l'autorisation

Les demandes de capture ne sont approuvées que pendant la période d’autorisation. Une fois la période d’autorisation écoulée, nous annulons tous les fonds non perçus et les retournons au client. Vous recevez 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 pouvez utiliser l’API de capture pour transmettre à Affirm les fonds spécifiés à capturer dans le paramètre de montant. Vous pouvez envoyer des requêtes Capture autant de fois que nécessaire dans la période d'autorisation tant que le montant total saisi ne dépasse pas le montant autorisé.

Error Handling

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 (Pour plus de détails, voir la section Idempotence ci-dessous).

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, vous pouvez effectuer un remboursement pour le montant capturé afin que nous créditions 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 passez amount, l'intégralité du prêt sera remboursée.

Annulations partielles

Lorsque vous initiez des requêtes de capture fractionnée et savez qu’un montant spécifique ne sera pas capturé avant l’expiration de l’autorisation, vous pouvez appeler le point de terminaison d'annulation pour le montant spécifié de fonds qui ne sera pas capturé. Après avoir créé une annulation, nous créditons le montant spécifié au prêt du client.

🚧

Note

  • 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 statut Authorized.

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 identificateurs 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 nécessaires 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.
Remarque : 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.

Sujets recommandés