Documentation
Documentation
Comptabilisations

1Introduction

Après avoir été autorisées, les transactions se trouvent dans l’état Authorized. Pour plus d’informations, consultez le processus de transaction. La fonctionnalité que nous appelons complete est également connue sous le nom de capture ou activate. Cette terminologie peut varier selon le contexte, mais la fonctionnalité fait référence à l’action qui déclenche réellement le transfert d’argent du compte du client vers le compte du marchand.

Certains modes de paiement peuvent être configurés de manière à compléter le paiement de façon différée et à seulement autoriser le paiement côté processeur. Dans ce cas, le montant de la commande peut être réduit et les articles du panier peuvent être modifiés jusqu’à ce que vous complétiez la transaction.

Note
 Tous les modes de paiement ne prennent pas en charge les complétions. Si vous souhaitez obtenir un processus unifié pour tous les modes de paiement, nous vous recommandons de compléter le paiement immédiatement. Les informations sur les modes de paiement et leur prise en charge de la complétion différée se trouvent dans la liste des connecteurs de paiement.

2Détails d’intégration

Avant de pouvoir compléter une transaction, vous devriez avoir pris connaissance des guides suivants

Si vous souhaitez annuler une transaction non complétée, vous devez l’annuler (void). Consultez la documentation sur l’annulation des transactions pour savoir comment annuler des transactions.

2.1Modifier les postes dans le back office

Vous pouvez modifier les postes dans le back office. Pour cela, vous devez ouvrir la transaction sous Space > Paiement > Transactions. Cliquez sur l’onglet Postes puis sur Modifier les postes. Vous pouvez enregistrer vos modifications en cliquant sur Mettre à jour les postes.

Lors de la modification des postes via le service web ou dans le back office, une nouvelle version est créée. Vous pouvez voir les versions dans l’onglet Version de la transaction.

Note
 Des données incohérentes peuvent apparaître si vous modifiez les postes uniquement dans le back office et pas également dans votre application.

2.2Compléter une transaction dans le back office

Les transactions peuvent également être complétées dans le back office. Une transaction restera dans l’état Authorized jusqu’à ce qu’elle ait été complétée. Les transactions peuvent être complétées de deux manières :

  1. Compléter en ligne : si vous complétez une transaction en ligne, nous envoyons la requête de complétion au processeur.

  2. Compléter hors ligne : la complétion hors ligne simule la complétion, mais la requête ne sera pas transmise au processeur. Cette fonctionnalité peut être utilisée si vous avez déjà complété le paiement auprès du processeur et que vous ne pouvez plus l’envoyer en mode en ligne.

Les complétions réussies peuvent être consultées dans l’onglet Complétion de la transaction.

2.3Modifier les postes via le service web

Tant que la transaction n’est pas Completed, vous pouvez changer et modifier les postes à votre guise. Utilisez l’opération create line item version pour mettre à jour des postes existants via l’API.

Requête

Dans l’exemple de requête ci-dessous, nous mettons à jour un poste existant et fixons le nouveau prix à 70 CHF au lieu des 75 CHF initiaux définis dans la transaction d’origine.

{
    "externalId": "my-external-id",
    "lineItems": [
        {
            "amountIncludingTax": "70",
            "name": "Chelsea Tee",
            "quantity": "1",
            "shippingRequired": true,
            "sku": "mtk004",
            "type": "PRODUCT",
            "uniqueId": "2622"
        }
    ],
    "transaction": 109575
}

2.4Envoyer la requête de complétion

Dès que vous savez que vous ne souhaitez plus modifier la transaction et que vous voulez la traiter, vous pouvez compléter la transaction en envoyant la requête de complétion via le service web à l’aide du Transaction Completion Service. Vous avez la possibilité de compléter la transaction online ou offline selon que vous souhaitez ou non l’envoyer au processeur.

2.5Et ensuite ?

Après avoir été complétée, une transaction passe à l’état Completed puis, selon le mode de paiement, directement à l’état Fulfill (consultez le processus de transaction pour plus d’informations sur les changements d’état). La documentation sur les remboursements explique comment les transactions complétées peuvent être remboursées au client.

Staging 2.218.3