Documentation
Documentation
Remboursements

1Introduction

Les transactions qui se trouvent dans l’état Completed ou Fulfill peuvent être remboursées et l’argent peut être restitué au client. Pour plus d’informations, consultez le processus de transaction.

Note
 Tous les modes de paiement ne permettent pas d’autoriser les transactions de manière différée. Afin d’avoir un processus plus simple, nous vous recommandons de travailler avec des remboursements plutôt qu’avec des complétions.

2Détails d’intégration

Avant de pouvoir compléter une transaction, vous devriez avoir pris en compte les guides suivants :

Vous trouverez ci-dessous plus d’informations sur la manière d’émettre un remboursement dans le back-office de l’application ou d’utiliser le web service afin d’intégrer le processus de remboursement à distance dans votre application.

2.1Remboursements en ligne vs hors ligne

Un remboursement peut être émis de deux manières :

  • En ligne : si vous remboursez une transaction en ligne, nous envoyons la demande de remboursement directement au processeur.

  • Hors ligne : le remboursement hors ligne simule le remboursement dans notre plateforme mais n’envoie pas le remboursement au processeur. Cette fonctionnalité peut être utilisée si vous avez déjà remboursé le paiement auprès du processeur et que vous ne pouvez plus l’envoyer en mode en ligne.

2.2Créer un remboursement dans le back-office

Les remboursements se trouvent dans le back-office sous Space > Paiement > Transactions. Ouvrez la transaction. Si la transaction a été complétée, vous devriez trouver l’onglet de transaction Remboursements. Le back-office offre un moyen simple et pratique d’émettre des remboursements en ligne ou hors ligne.

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

2.3Créer un remboursement via le web service

Vous pouvez rembourser une transaction complétée via le web service en utilisant le service de remboursement.

Vous avez la possibilité d’émettre un remboursement basé sur une réduction de quantité ou sur le prix unitaire. Vous ne devriez pas les combiner, car cela peut conduire à des résultats inattendus. Afin d’obtenir la ligne d’article que vous pouvez rembourser, vous devrez d’abord lire (read) la transaction. Cela fournira les informations nécessaires à l’émission du remboursement.

Nous distinguons différents types de remboursement :

  • CUSTOMER_INITIATED_AUTOMATIC / MANUAL : un remboursement est initié par le client lorsque le remboursement n’a pas été déclenché avec le consentement du marchand. Cela peut se produire à la suite d’une rétrofacturation sur la transaction par carte de crédit ou par prélèvement.

  • MERCHANT_INITIATED_ONLINE / OFFLINE : un remboursement initié par le marchand est déclenché avec le consentement du marchand.

Réponse de la transaction

Vous trouverez ci-dessous un extrait de la réponse à la lecture (read) de la transaction que nous voulons rembourser.

"lineItems": [{
    "aggregatedTaxRate": 0,
    "amountExcludingTax": 70,
    "amountIncludingTax": 70,
    "attributes": {
        "color": {
            "label": "Color",
            "value": "Black"
        },
        "size": {
            "label": "Size",
            "value": "S"
        }
    },
    "name": "Chelsea Tee",
    "quantity": 1,
    "shippingRequired": true,
    "sku": "mtk004",
    "taxAmount": 0,
    "taxAmountPerUnit": 0,
    "taxes": [],
    "type": "PRODUCT",
    "uniqueId": "2622",
    "unitPriceExcludingTax": 70,
    "unitPriceIncludingTax": 70
}

Requête

Sur la base de ces informations, nous pouvons émettre la demande de remboursement en utilisant la méthode Refund Create de l’API.

{
    "externalId": "1",
    "reductions": [
        {
            "lineItemUniqueId": "2622",
            "quantityReduction": "1",
            "unitPriceReduction": "70"
        }
    ],
    "transaction": 109575,
    "type": "MERCHANT_INITIATED_ONLINE"
}
Staging 2.218.3