1. Introduction

SwissBilling est une société Suisse, filiale de la banque Cembra Money Bank, créée en 2011. Elle s'est donnée pour mission de fournir un moyen de paiement en ligne par facture, simple d'utilisation, aux clients en ligne Suisses. Elle leur offre ainsi la possibilité de payer leurs achats x jours après leur réception. Le marchand peut modifier la facture avant (annulation) ou après (remboursement) l'expédition.
Avant d'accepter un paiement, SwissBilling effectue un contrôle de solvabilité en consultant des bases de données Suisses et l'historique de crédit du client SwissBilling. Dès l'approbation d'une commande, SwissBilling ouvre une note de crédit pour le client et prend une décision quant à son éligibilité et à ses demandes de paiement.
Le paiement par facture est le moyen de paiement préféré des clients Suisses.

2. Flux

Les transactions via SwissBilling suivent le flux ci-après :
1. Le client remplit son panier sur le site Web du client, le valide, puis sélectionne SwissBilling comme moyen de paiement. La page de sélection du moyen de paiement peut être hébergée par le marchand ou par PostFinance.
2. Le client est redirigé vers SwissBilling, via un URL fourni par SwissBilling, incluant une référence de transaction unique et l'identification du marchand.
3. Le client demande que le paiement soit effectué via la fonction Payer par facture (paiement après la livraison). SwissBilling vérifie ensuite la solvabilité du client.
4. Le client est redirigé vers le marchand via PostFinance. Le marchand reçoit ensuite un statut de transaction via PostFinance.

3. Intégration

3.1 Configuration

Pour activer le moyen de paiement, le marchand doit avoir passé un contrat d'acquisition avec SwissBilling.

La création d’une nouvelle transaction SwissBilling fonctionne uniquement en mode e-Commerce. Assurez-vous de toujours envoyer votre demande à notre UTF-8 en version URL en mode POST.

Une fois qu'un accord de vente basé sur un moyen de paiement est signé, le marchand doit contacter notre équipe MerchantHelp afin de configurer et activer le moyen de paiement.
Quand le moyen de paiement est configuré et activé, il apparaît dans la section Banque web de votre compte PostFinance.
La procédure de paramétrage d'un compte est la suivante :

  • Le marchand signe un contrat avec SwissBilling.
  • Le marchand ou SwissBilling en communique les détails à notre équipe MerchantHelp.
  • PostFinance s'assure de l'activation de SwissBilling pour le marchand.

3.2 Sélection du moyen de paiement

Description
PM / BRAND: SwissBilling

3.3 Paramètres de saisie

Paramètre Description
PSPID Votre nom d'affiliation dans notre système
Longueur: 50
Obligatoire
ORDERID Référence de la commande du marchand
Longueur: 50
Obligatoire
EMAIL Adresse électronique du client
Longueur: 6
Obligatoire
AMOUNT Montant de la transaction
Longueur: 6
Obligatoire
CURRENCY Devise de la commande (toujours
CHF pour SwissBilling)
Longueur: ISO Alpha code
Obligatoire
LANGUAGE Langue du client
Longueur: 5
Facultatif
REF_CUSTOMERID Numéro de client
Longueur: 20
Facultatif
ECOM_BILLTO_COMPANY Nom de la société du client
Longueur: 50
Facultatif
ECOM_BILLTO_POSTAL_NAME_PREFIX Préfixe du client
Longueur: 4
Facultatif
ECOM_BILLTO_POSTAL_NAME_LAST Nom de famille du client
Longueur: 35
Obligatoire
ECOM_BILLTO_POSTAL_NAME_FIRST Prénom du client
Longueur: 35
Obligatoire
ECOM_BILLTO_POSTAL_STREET_NUMBER Numéro de rue du client
Longueur: 10
Obligatoire
ECOM_BILLTO_POSTAL_STREET_LINE1 Rue du client (ligne 1)
Longueur: 35
Obligatoire
ECOM_BILLTO_POSTAL_STREET_LINE2 Rue du client (ligne 2)
Longueur: 35
Facultatif
ECOM_BILLTO_POSTAL_POSTALCODE Code postal du client
Longueur: 5
Obligatoire
ECOM_BILLTO_POSTAL_CITY Ville du client
Longueur: 25
Obligatoire
ECOM_BILLTO_POSTAL_COUNTRYCODE Code pays du client
Longueur: 2
Obligatoire
ECOM_BILLTO_TELECOM_MOBILE_NUMBER Numéro de portable du client
Longueur: 20
Facultatif
ECOM_BILLTO_TELECOM_PHONE_NUMBER Numéro de téléphone du client
Longueur: 20
Facultatif
ECOM_SHIPTO_COMPANY Nom de la société du client (livraison)
Longueur: 50
Facultatif
ECOM_SHIPTO_POSTAL_NAME_PREFIX Préfixe du client (livraison)
Longueur: 4
Facultatif
ECOM_SHIPTO_POSTAL_NAME_FIRST Prénom du client (livraison)
Longueur: 35
Obligatoire
ECOM_SHIPTO_POSTAL_NAME_LAST Nom de famille du client (livraison)
Longueur:
Obligatoire
ECOM_SHIPTO_POSTAL_STREET_NUMBER Numéro de rue du client (livraison)
Longueur: 10
Obligatoire
ECOM_SHIPTO_POSTAL_STREET_LINE1 Rue du client (livraison) (ligne 1)
Longueur: 35
Obligatoire
ECOM_SHIPTO_POSTAL_STREET_LINE2 Rue du client (livraison) (ligne 2)
Longueur: 35
Facultatif
ECOM_SHIPTO_POSTAL_POSTALCODE Code postal du client (livraison)
Longueur: 5
Obligatoire
ECOM_SHIPTO_POSTAL_CITY Ville du client (livraison)
Longueur: 25
Obligatoire
ECOM_SHIPTO_POSTAL_COUNTRYCODE Code pays du client (livraison)
Longueur: 2
Obligatoire
ECOM_SHIPTO_TELECOM_MOBILE_NUMBER Numéro de portable du client (livraison)
Longueur: 20
Facultatif
ECOM_SHIPTO_TELECOM_PHONE_NUMBER Numéro de téléphone du client (livraison)
Longueur: 20
Facultatif
GENERIC_BL_DATA Informations de la liste noire générique du client
Longueur: 50
Facultatif
ITEMIDX Identifiant de l'article
Longueur: 15
Obligatoire
ITEMNAMEX Nom de l'article
Longueur: 40
Obligatoire
ITEMPRICEX Prix unitaire de l'article. ITEMPRICEX accepte uniquement le montant de la saisie.
Longueur: 10
Obligatoire
ITEMVATCODEX Code TVA de l'article
Longueur: 6
Obligatoire
ITEMQUANTX Quantité d'article
Longueur: 4
Obligatoire
ITEMCATEGORYX Catégorie d'article
Longueur: 50
Obligatoire

ITEMCATEGORYX
accepte uniquement les valeurs suivantes :
  • ComputersAndSoftware
  • Electronics
  • Phones
  • Appliances
  • HomeAndGarden
  • Fashion
  • HealthAndBeauty
  • Jewellery
  • Sport
  • LeisureAndHobbies
  • CarsAndMotorbikes
  • Furniture
  • KidsAndBaby
  • VideoGamesAndConsoles
  • ToysAndGames
  • Pets
  • FoodAndDrink
  • GiftAndFlowers
  • Entertainment
  • Travel
  • AuctionsAndGroupBuying
  • ServicesForIndividuals
  • ServicesForProfessionals
Avec ITEMCATEGORYX, vous (le marchand) devez d'abord définir ces catégories (ITEMCATEGORY1=SPORT, ITEMCATEGORY2=FOOD, etc.) puis utiliser le paramètre dans la
transaction. Exemple: “<input type="hidden" name="ITEMCATEGORY1" value="SPORT"/>” .
Vous devez utiliser 1* ITEMCATEGORY
par article. Exemple :ITEMCATEGORY per item, for example:
<input type="hidden" name="ITEMCATEGORY1" value="SPORT"/>
<input type="hidden" name="ITEMID1" value="2855"/>
<input type="hidden" name="ITEMNAME1" value="Adibok Supershoe"/>
<input type="hidden" name="ITEMPRICE1" value="3999"/>
<input type="hidden" name="ITEMQUANT1" value="1"/>
<input type="hidden" name="ITEMVATCODE1" value="20%"/>
<input type="hidden" name="TAXINCLUDED1" value="1"/>
TAXINCLUDEDX Elle doit toujours être envoyée avec TAXINCLUDEDX=1 (ITEMPRICEX inclut la VAT)
Longueur: 1
Obligatoire

REMARQUES IMPORTANTES :

  • SwissBilling ne peut être utilisé qu'avec la devise CHF et les clients Suisses. Un article doit également avoir un prix supérieur à 0.00CHF.
  • Le marchand peut choisir une solution B2B ou B2C à la demande d'inscription. Pour la solution B2B, les paramètres relatifs au nom de la société sont obligatoires.
  • Les adresses d'expédition et de facturation doivent être identiques pour que SwissBilling approuve la commande !

4. Traitement des transactions et opérations de maintenance

4.1 Opérations de maintenance

Avec SwissBilling, les opérations de maintenance, telles que la capture des données, les annulations et les remboursements, peuvent être réalisées via les fonctionnalités manuelles standard du Back Office ou via DirectLink (maintenance directe).

4.1.1 Opérations de maintenance du Back Office

Confirmer les transactions autorisées

Suivez les étapes ci-après afin de traiter et de confirmer vos transactions selon la procédure de paiement Capture de données par le marchand (manuelle ou automatique) :

1. Sélectionnez cette option dans Configuration > Informations techniques > Paramètres généraux de transaction > Procédure de capture des données (paiement) par défaut.

2. Confirmez la transaction manuelle quand le statut est « 5 - Autorisé ». L'autorisation consiste uniquement en une réservation du montant sur la carte ou le compte de votre client ou en une vérification en référence à une liste noire. Elle ne constitue PAS un paiement.

a. Recherchez la transaction dans Opérations > Afficher les transactions.

b. Cliquez sur le bouton Confirmer le paiement (capture de données) : XXXXXXXX/X au bas de l'onglet - Détails de la commande.

  • Le statut passe à « 91 - Traitement du paiement ».
  • Quand nous recevons la confirmation de la capture de données de votre acquéreur, le statut passe à « 9 - Paiement demandé ». Ce statut signifie que nous avons demandé à votre acquéreur de transférer l'argent qu'il a réservé sur votre compte bancaire. Étant donné que l'acquéreur transfère lui-même le montant sur votre compte bancaire, nous ne sommes pas en mesure de dire quand vous recevrez le paiement.

Vous préférez les opérations automatisées ?

Batch: envoyer le code d'opération SAS dans le champ 10

DirectLink: envoyer operation=SAS

Annuler et rembourser des paiements
Annuler un paiement
Une annulation de paiement correspond à l'annulation d'une demande de paiement faite à l'acquéreur. Cette action est possible uniquement pour les paiements par carte de crédit. L'annulation d'un paiement implique normalement qu'aucun mouvement ne soit effectué sur le compte bancaire du client (ni débit, ni crédit).
Contrainte : Un paiement peut être annulé le jour de la capture des données et jusqu'à l'heure du retrait, comme configuré pour votre compte. L'heure du retrait se produit lorsque nous envoyons toutes les demandes de paiement à l'acquéreur. L'heure du retrait peut varier selon l'acquéreur, mais elle se produit généralement entre 16:00 et minuit CET. Si le client change d'avis après expiration de l'échéance, vous devrez effectuer un remboursement.

Pour annuler un paiement :
1. Recherchez la transaction dans Opérations > Afficher les transactions.
2. Cliquez sur le bouton Annuler le paiement : XXXXXXXX/X au bas de l'onglet Commandes.

Vous préférez les opérations automatisées ?

Batch: envoyer le code d'opération DES dans le champ 10

DirectLink: envoyer operation=DES

Rembourser un paiement
Un remboursement implique que le montant a bien été débité du compte bancaire du titulaire de la carte et qu'il a ensuite été recrédité. Ces deux mouvements apparaîtront sur le relevé du titulaire de la carte.

Contraintes:

  • L'option doit être activée dans votre compte.
  • Votre acquéreur doit autoriser les remboursements.
  • Les remboursements doivent être rendus possibles pour le moyen de paiement spécifique. La disponibilité de l'option de remboursement dépend de votre abonnement.

Si votre acquéreur n'autorise pas les remboursements automatisés, c'est lui qui devra s'en charger directement.

Comment rembourser un paiement ?
1. Recherchez la transaction que vous souhaitez rembourser Afficher les transactions > Détails de la transaction.

2. Cliquez sur le bouton Rembourser, au bas de l'onglet Commandes. Vous pouvez également introduire la raison de ce remboursement.

Vous préférez les opérations automatisées ?

Batch: envoyer le code d'opération RFS dans le champ 10

DirectLink: envoyer operation=RFS

Vous souhaitez rembourser plus que le montant payé ?
Dans le cas des cartes de crédit, il est possible de rembourser un montant supérieur au montant payé à l'origine. Cependant, ne perdez pas de vue les contraintes mentionnées ci-dessus, et n'oubliez pas que votre acquéreur « carte de crédit » peut ne pas prendre en charge cette possibilité.
Par ailleurs, l'option Maintenance partielle doit être activée dans votre compte pour qu'il vous soit possible de modifier le montant original dans la vue générale de la transaction. Si vous utilisez cette fonction, contactez notre équipe MerchantHelp.

Vous souhaitez rembourser plus que le montant payé ?
Dans le cas des cartes de crédit, il est possible de rembourser un montant supérieur au montant payé à l'origine. Cependant, ne perdez pas de vue les contraintes mentionnées ci-dessus, et n'oubliez pas que votre acquéreur « carte de crédit » peut ne pas prendre en charge cette possibilité.
Par ailleurs, l'option Maintenance partielle doit être activée dans votre compte pour qu'il vous soit possible de modifier le montant original dans la vue générale de la transaction.
Si vous utilisez cette fonction, contactez notre équipe MerchantHelp.

Opérations spéciales sur les transactions autorisées

La demande d'une autorisation implique de vérifier la validité d'une carte ou d'un compte ainsi que le montant disponible. L'acquéreur peut alors réserver le montant spécifiquement demandé sur la carte ou le compte du client pour une période prédéfinie et un marchand spécifique.
Outre la demande d'autorisation, notre système permet également d’annuler et de renouveler les autorisations, ou encore de procéder à des autorisations manuelles. Les deux dernières opérations sont seulement disponibles pour les paiements par carte de crédit.

Annuler une autorisation

Dès que la transaction est autorisée, l'acquéreur réserve un montant monétaire spécifique sur le compte/la carte du client (ou la demande est analysée en référence à une liste noire), qui vous sera versé lorsque le paiement sera demandé. Notre plateforme permet d'annuler les autorisations, mais tous les acquéreurs ne prennent pas en charge ce type d'opération.
Pour annuler une autorisation via notre plateforme, recherchez la transaction dans l'écran de sélection Afficher les transactions, puis cliquez sur le bouton Annuler l'autorisation en bas de la page des détails de la commande. Dans tous les cas, nous simulons l'annulation de l'autorisation même si l'acquéreur ne prend pas en charge cette opération.

Vous préférez les opérations automatisées ?

Batch: envoyer le code d'opération DES dans le champ 10

DirectLink: envoyer operation=DES

Renouveler une autorisation

La période de validité d'une autorisation dépend de l'acquéreur. Les détails de la transaction affichent le nombre de jours restants avant que l'autorisation n'expire pour chaque transaction. Ce nombre de jours est donné à titre indicatif seulement. La période d'autorisation exacte est indiquée dans le contrat passé avec votre acquéreur.

Si l'autorisation n'a pas été suivie d'une capture de données (demande de paiement) pendant la période de temps prédéfinie, elle s'affiche en rouge, ce qui signifie qu'elle a expiré. Ainsi, la garantie pour le marchand que le montant de la transaction est encore disponible pour lui sur la carte ou le compte du client n'existe plus.
Vous pouvez quand même demander le paiement (sans autorisation valide), mais celui-ci peut être refusé,
notamment dans l'éventualité de fonds insuffisants.

Avant de demander le paiement, vous pouvez redemander l'autorisation dans votre Back Office. Cela signifie que vous demandez à l'acquéreur de vous réserver l'argent de nouveau. Cependant, il est possible que le titulaire ait utilisé sa carte entre-temps et qu'il n'y ait plus les fonds suffisants pour vous payer.
Pour redemander une autorisation, recherchez la transaction dans l'écran de sélection Afficher les transactions et cliquez sur le bouton Redemander une autorisation en bas de la page des détails de la commande (si le bouton n'est pas immédiatement disponible, cliquez d'abord sur le bouton Avancé).

Si l'autorisation originale a été obtenue avec le protocole 3-D Secure, les conditions 3-D Secure originales peuvent ne plus s'appliquer à l'autorisation renouvelée. Selon les règlements internationaux de VISA et de MasterCard, le client doit s'identifier lui-même pour chacune des autorisations afin de bénéficier de la garantie 3-D Secure. Les règles de garantie de paiement conditionnel de 3-D Secure sont gérées exclusivement entre le marchand (vous) et son acquéreur. Veuillez contacter votre acquéreur pour plus d'informations.

La disponibilité de l'option Redemander une autorisation dépend de votre abonnement. L'option doit être activée par notre équipe MerchantHelp.

Vous préférez les opérations automatisées ?

Batch: envoyer le code d'opération REN dans le champ 10

DirectLink: envoyer operation=REN

Exécuter une autorisation manuelle

Parfois, l'acquéreur ne peut émettre d'autorisation automatiquement, par exemple lorsque vous avez atteint votre limite autorisée de transactions. L'acquéreur refuse l'autorisation et renvoie un message vous demandant de contacter le Centre d'appel du marchand. Lorsque vous contactez l'acquéreur et qu'il décide d'émettre l'autorisation, il peut vous donner un code d'autorisation par téléphone.
Vous pouvez entrer le code d'autorisation que l'acquéreur vous aura fourni (par téléphone, fax, etc.) dans votre Back Office. Recherchez la transaction dans l'écran de sélection Afficher les transactions. Lorsque vous demandez les détails de la transaction, le bouton Autorisation manuelle s'affiche en bas de la page (si le bouton n'est pas immédiatement disponible, cliquez d'abord sur le bouton Avancé). Entrez le code d'autorisation que l'acquéreur vous a donné dans le champ en regard du bouton Autorisation manuelle, puis cliquez sur ce dernier.
Le marchand est entièrement responsable de la saisie manuelle du code d'autorisation, même si la transaction affiche ultérieurement le statut 9 et qu'aucun paiement réel n'est réalisé.
Si vous avez passé un contrat 3-D Secure avec votre acquéreur, les conditions de 3-D Secure s'appliquant pour une
autorisation standard via le protocole 3-D Secure peuvent différer de celles de l'autorisation manuelle. Selon les règlements internationaux de VISA et de MasterCard, le client doit s'identifier lui-même pour chacune des autorisations afin de bénéficier de la garantie 3-D Secure. Les règles de garantie de paiement conditionnel de 3-D Secure sont gérées exclusivement entre le marchand (vous) et son acquéreur.
Veuillez contacter votre acquéreur pour plus d'informations.

Opérations partielles et multiples

Les opérations partielles permettent de réaliser des captures de données, des annulations d'autorisation et des remboursements pour un plus petit montant que la commande originale. Les opérations multiples permettent de réaliser plusieurs captures de données, annulations d'autorisation et remboursements sur la même transaction. Cette option est proposée en plus de l'option des opérations partielles. La disponibilité des options pour les opérations partielles ou multiples dépend de votre abonnement. Votre acquéreur doit par ailleurs autoriser ces opérations. L'option doit être activée par notre équipe MerchantHelp. Lorsque l'option des opérations partielles est activée dans votre compte, des champs de texte s'affichent en regard des boutons de maintenance, en bas de la page des détails de la commande permettant de saisir un montant. Lorsque l'option des opérations multiples est activée dans votre compte, une case à cocher Dernier apparaît en regard des champs de texte permettant de saisir un montant.

Opérations partielles

Pour réaliser une opération de capture de données, de remboursement ou d'annulation, allez à la page des détails de la transaction, où s'affiche le bouton Confirmer le paiement (capture de données)/Rembourser/Annuler l'autorisation, en bas de la page.

1. Indiquez le montant partiel dans le champ en regard du bouton correspondant (le montant affiché par défaut est le montant total).

2. Cliquez sur le bouton correspondant pour confirmer.

Vous préférez les opérations automatisées ?

Captures de données

Batch: envoyer le code d'opération SAS dans le champ 10

DirectLink: envoyer operation=SAS

Remboursements

Batch: envoyer le code d'opération RFS dans le champ 10

DirectLink: envoyer operation=RFS

Annulation d'une autorisation

Batch: envoyer le code d'opération DES dans le champ 10

DirectLink: envoyer operation=DES

Opérations multiples

Pour réaliser des captures de données ou des remboursements multiples, ou encore une annulation d'autorisation en laissant la transaction ouverte pour des opérations de maintenance futures, il vous suffit d'aller à la page des détails de la transaction, où se trouve le bouton Confirmer le paiement (capture de données)/Rembourser/Annuler l'autorisation, en bas de la page.
1. Indiquez le montant partiel dans le champ en regard du bouton correspondant (le montant affiché par défaut est le montant total).
2. Cochez la case Dernier s'il s'agit de la dernière opération à réaliser pour cette transaction OU décochez la case Dernier si vous comptez encore réaliser une autre opération pour cette transaction (p. ex. demander un montant de 50,00 EUR pour les articles que vous avez déjà envoyés au client et demander le solde du montant de la transaction lorsque vous expédiez le reste de la commande).
3. Cliquez sur le bouton correspondant pour confirmer.

Vous préférez les opérations automatisées ?

Captures de données

Batch: envoyer le code d'opération SAL (d'autres opérations vont suivre) ou SAS (c'est la dernière) dans le champ 10

DirectLink: envoyer operation=SAL (d'autres opérations vont suivre) ou operation=SAS (c'est la dernière)

Remboursements

Batch: envoyer le code d'opération RFD (d'autres opérations vont suivre) ou RFS (c'est la dernière) dans le champ 10

DirectLink: envoyer operation=RFD (d'autres opérations vont suivre) ou operation=RFS (c'est la dernière)

Annulation d'une autorisation

Batch: envoyer le code d'opération DEL (d'autres opérations vont suivre) ou DES (c'est la dernière) dans le champ 10

DirectLink: envoyer operation=DEL (d'autres opérations vont suivre) ou operation=DES (c'est la dernière)

Maintenance directe
Une demande de maintenance directe de votre application permet les actions suivantes :

  • Effectuer une capture de données (paiement) d'une commande autorisée automatiquement (et non manuellement dans le Back Office)
  • Annuler l'autorisation d'une commande
  • Renouveler l'autorisation d'une commande
  • Rembourser une commande payée

Les captures de données, autorisations d'annulation et renouvellement d'autorisation sont spécifiquement pour les marchands ayant configuré leurs compte/demandes de sorte à effectuer l'autorisation et la capture de données en deux étapes.

Demande de maintenance

1. Demande de URL
La demande de URL dans l'environnement TEST est https://e-payment.postfinance.ch/ncol/test/maintenancedirect.asp.
La demande de URL dans l'environnement PRODUCTION est https://e-payment.postfinance.ch/ncol/prod/maintenancedirect.asp.

Remplacer « test » par « prod »

Remplacer « test » par « prod » dans l'URL de demande quand vous passez à votre compte de production. Si vous oubliez de modifier l'URL de demande, lorsque vous commencez à travailler avec de vraies commandes, vos transactions de maintenance seront envoyées à l'environnement de test et non aux acquéreurs/banques.

1.2 Paramètres des demandes

Le tableau ci-après contient les paramètres des demandes obligatoires nécessaires à l'opération de maintenance :

Champ Description
AMOUNT Montant de la commande multiplié par 100
Obligatoire uniquement quand le montant de la maintenance diffère du montant de l'autorisation original. Toutefois, nous vous recommandons de l'utiliser dans tous les cas.
Notre système vérifie que le montant de la transaction de maintenance n'est pas supérieur au montant de l'autorisation/du paiement.
OPERATION
Valeurs possibles :
  • REN: renouvellement de l'autorisation, si l'autorisation originale n'est plus valide.
  • DEL: annulation de l'autorisation, ce qui laisse la transaction ouverte à la possibilité d'opérations de maintenance plus approfondies
  • DES: annulation de l'autorisation, ce qui ferme la transaction après ce remboursement.
  • SAL: saisie partielle des données (paiement), ce qui laisse la transaction ouverte à la possibilité de saisie d'autres données.
  • SAS: (dernière) saisie de données partielle ou complète (paiement), ce qui ferme la transaction (pour d'autres saisies de données), après cette saisie de données.
  • RFD: remboursement partiel (sur une facture payée), ce qui laisse la transaction ouverte à la possibilité d'un autre remboursement.
  • RFS: (dernière) saisie de données partielle ou complète (sur une facture payée), ce qui ferme la transaction après ce remboursement.
Veuillez noter que pour DEL et DES, tous les acquéreurs ne prennent pas en charge l'annulation des autorisations. Si votre acquéreur ne prend pas en charge DEL/DES, nous simulons toutefois l'annulation de l'autorisation dans le Back Office.
ORDERID Vous pouvez envoyer le PAYID ou l'orderID pour identifier la commande d'origine. Nous vous recommandons d'utiliser le PAYID.
PAYID Le PSPID de votre compte
PSPID L'identification de votre PSP
PSWD Le mot de passe de votre utilisateur API
SHASIGN
Signature (chaîne hachée) permettant d'authentifier la date (voir SHA-IN-signature)
USERID
Votre utilisateur API

1.2.1 Page de test
Vous pouvez tester vos demandes de maintenance directe ici : https://e-payment.postfinance.ch/ncol/test/testdm.asp

2. Réponse de maintenance

Notre serveur renvoie une réponse XML à la demande de maintenance :
Exemple de réponse XML à une demande de maintenance directe

<?xml version=”1.0”?>
< ncresponse orderID=”99999” PAYID=”1111111” PAYIDSUB=”3” NCSTATUS=”0” NCERROR=””
NCERRORPLUS=”” ACCEPTANCE=”12345” STATUS="91" amount="125" currency="EUR"/>

Le tableau suivant répertorie la liste des attributs de balise des réponses nc :

Devise de la commande
Champ Description
ACCEPTANCE Code d'acceptation renvoyé par un acquéreur
AMOUNT Montant de la commande (non multiplié par 100)
CURRENCY
NCERROR Code d'erreur
NCERRORPLUS Explication du code d'erreur
NCSTATUS Premier chiffre de NCERROR
ORDERID Référence de votre commande
PAYID Référence du paiement dans notre système
PAYIDSUB
ID du niveau historique pour les opérations de maintenance sur le PAYID
STATUS Statut de la transaction (Possible statuses)

Les attributs des balises des réponses nc standard sont les mêmes que ceux des réponses XML à une nouvelle commande, à l'exception de l'attribut supplémentaire PAYIDSUB.
1.3 Demande en double
Si une maintenance est demandée deux fois pour la même commande, la deuxième commande est théoriquement refusée, avec l'erreur « 50001127 » (Cette commande n'est pas autorisée), puisque la transaction initiale réussie a modifié le statut de la commande.

4.1.3 Autorisation et capture

SwissBilling suit un flux en deux étapes, ce qui signifie que l'autorisation et la capture peuvent être séparées dans le processus de commande. Toutefois, seules les captures complètes sont acceptées dans SwissBilling.

4.1.4 Remboursements

Pour plus d'informations sur les remboursements, voir Chapitre 3.1 Opérations de maintenance.

4.1.5 Identifiants de test

Des tests sont exécutés sur SwissBilling. Contactez notre équipe MerchantHelp pour paramétrer un test de bout en bout.
Le test doit inclure le MerchantID, le mot de passe et le ShopID fournis à la signature du contrat avec SwissBilling.