Table des matières
giropay
Informations générales sur giropay
giropay est une norme fondée par les banques allemandes Sparkasse, Postbank, Volksbank et Raiffeisenbank. Le virement en ligne giropay présente un certain nombre d'avantages pour les commerçants. Pour commencer, giropay accorde au vendeur une garantie pour des paiements jusqu'à 10.000 euros ; ensuite, le virement constitue un paiement anticipé qui réduit les délais de paiement. Enfin, l'acheteur utilise la banque en ligne bien connue et fiable de son propre établissement de crédit - comme pour toutes les opérations bancaires en ligne.
Dans une première étape, l'acheteur sélectionne le mode de paiement giropay lors du passage à la caisse de la boutique en ligne, avant de choisir son établissement de crédit. L'acheteur est ensuite connecté directement avec sa banque ou Sparkasse et ouvre une session normale avec son code PIN. Il accède alors à un formulaire de virement pré-complété. L'acheteur doit simplement entrer son numéro d'authentification de transaction TAN afin de confirmer le paiement.
Avec la banque en ligne, les données transmises pour le virement en ligne sont chiffrées SSL (Secure Socket Layer) afin de prévenir toute manipulation.
| giropay est un système de virement en ligne avec code PIN et numéro d'authentification de transaction (TAN) qui vous donne accès à quelque 40 millions d'utilisateurs d'opérations bancaires en ligne en Allemagne et en Autriche. Outre la garantie de paiement 100%, l'utilisation de giropay est relativement bon marché. |
Vous trouverez de plus amples informations sur la page web de giropay (http://www.giropay.de).
Schéma de déroulement du processus
Déroulement du processus giropay
Interface Payment platform
Formats des données : a alphabétique as alphabétique avec caractères spéciaux n numérique an alphanumérique ans alphanumérique avec caractères spéciaux ns numérique avec caractères spéciaux bool expression booléenne (true ou false) 3 longueur fixe avec 3 chiffres/caractères ..3 longueur variable avec maximum 3 chiffres/caractères enum énumération de valeurs admissibles dttm Date et heure ISO (AAAA-MM-JJThh:mm:ss) Abréviations : CND condition M obligatoire (mandatory en anglais) O optionnel C conditionnel Remarque : Veuillez noter que les noms des paramètres peuvent être en majuscules ou en minuscules.
Appel de l'interface giropay
Pour entamer un paiement avec giropay, appelez l'adresse URL ci-dessous :
Remarque : pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Remarque : veuillez noter qu'une connexion via iFrame est impossible en raison des règlements techniques et sera techniquement annulée.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
|---|---|---|---|
MerchantID | ans..30 | M | ID du commerçant. Ce paramètre doit également être transféré non chiffré. |
TransID | ans..64 | M | ID de la transaction qui doit être univoque pour chaque paiement |
RefNr | ans..40 | OC | Numéro de référence univoque du commerçant. Seuls les caractères a-zA-Z0-9,-_ sont autorisés. |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217 |
OrderDesc | ans..384 | M | Description des marchandises achetées, des prix unitaires etc. Veuillez noter : les 27 premiers caractères apparaissent sur le relevé de compte du client. Consulter Analytics pour les données complètes. |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement |
URLSuccess | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas de réussite du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
URLFailure | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas d'échec du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
Response | a7 | O | État de la réponse envoyée par plateforme de paiement à URLSuccess et URLFailure, doit être chiffré. À cette fin, transmettez le paramètre Response=encrypt. |
URLNotify | ans..256 | O | Adresse URL complète appelée par plateforme de paiement pour notifier le résultat de paiement à la boutique. L'URL ne peut être appelée que par le port 443. Elle ne peut contenir aucun paramètre : utilisez le paramètre UserData pour ce faire. |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
SellingPoint | ans..50 | O | Point de vente |
Service | ans..50 | O | Produits ou services vendus |
Channel | ans..64 | O | Canal de configuration du contrat PPRO (Account et ContractID sont enregistrés au sein du système). Si ce paramètre est disponible, il remplace le cas échéant les canaux enregistrés au sein du système |
AccOwner | a..50 | O | Nom du titulaire de la carte au format |
Scheme | enum | O | Définit le schéma : « gir » ou « eps » |
BIC | ans..11 | O | Code d'identification de la banque |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 |
expirationTime | ans..19 | O | Horodatage pour la fin du traitement de la transaction, indiqué en UTC. Format : AAAA-MM-jjTHH:mm:ss |
Paramètres pour virements en ligne avec giropay
Le tableau suivant décrit les paramètres de réponse que plateforme de paiement transmet à URLSuccess ou URLFailure et URLNotify. Si vous avez spécifié le paramètre Response=encrypt, les paramètres suivants sont transmis à votre système avec chiffrement Blowfish :
Paramètre | Format | CND | Description | |
|---|---|---|---|---|
MID | ans..30 | M | ID du commerçant | |
PayID | an32 | M | ID attribuée au paiement par plateforme de paiement, par ex. pour le référencement au sein des fichiers batch. | |
XID | an32 | M | ID attribuée par plateforme de paiement pour toutes les différentes transactions (autorisation, capture, note de crédit) pour un paiement | |
TransID | ans..64 | M | Numéro de transaction du commerçant | |
Status | a..50 | M | OK (URLSuccess) ou FAILED (URLFailure) | |
Description | ans..1024 | M | Détails supplémentaires en cas d'échec du paiement. Veuillez ne pas utiliser le paramètre Description mais bien le paramètre Code pour une analyse de l'état de la transaction ! | |
Code | n8 | M | Code d'erreur conformément au fichier Excel des codes de réponse de la plateforme de paiement (partie du logiciel Client) | |
RefNr | ans..40 | OC | Numéro de référence univoque du commerçant. Seuls les caractères a-zA-Z0-9,-_ sont autorisés. | |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement | |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 | |
PaymentPurpose | ans..26 | O | Motif du paiement | |
PaymentGuarantee | a..12 | O | NONE = pas de garantie de paiement, VALIDATED = compte client valide mais pas de garantie de paiement, FULL = garantie de paiement Remarque : ce paramètre n'est retourné que si l'état est = OK. | |
ErrorText | ans..128 | O | Message d'erreur PPRO détaillé. Remarque : n'est retourné que si l'état = FAILED. Utilisation possible uniquement après concertation avec le Support. | |
TransactionID | an..20 | O | Numéro de transaction univoque pour PPRO | |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID | |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 | |
Paramètres de résultat pour URLNotify, URLSuccess et URLFailure, dans le cas de giropay
Vérification de l'état en ligne pour les banques giropay
Plateforme de paiement permet aux commerçants de vérifier les banques qui sont en ligne avant de traiter le paiement et du coup d'activer le paiement giropay. Appelez l'adresse URL ci-dessous pour procéder à cette vérification :
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
|---|---|---|---|
MerchantID | ans..30 | M | ID du commerçant. Ce paramètre doit également être transféré non chiffré. |
Tableau : Paramètres pour la vérification de l'état en ligne pour les banques giropay
Veuillez transférer l'ID du commerçant tant dans la chaîne de caractères non chiffrée que dans la chaîne chiffrée.
Le tableau ci-dessous décrit les paramètres de résultat que plateforme de paiement envoie comme réponse :
Paramètre | Format | CND | Description |
|---|---|---|---|
MerchantID | ans..30 | M | ID du commerçant. Ce paramètre doit également être transféré non chiffré. |
BICList | ans.. | M | Le paramètre BICList reprend toutes les banques qui sont en ligne au moment de la demande, sous forme de valeurs séparées par une virgule. Exemple : BICList=TESTBIC1,TESTBIC2,… |
Tableau : paramètres de résultat pour la demande relative aux banques giropay
Note de crédit avec référence
Les notes de crédit (remboursements) sont possibles via une connexion de serveur à serveur. La plateforme plateforme de paiement n'autorise que les notes de crédit pour giropay qui font référence à une transaction préalablement effectuée via plateforme de paiement. Le montant de la note de crédit est limité au montant de la capture précédente.
Pour exécuter une note de crédit avec une transaction de référence, veuillez utiliser l'adresse URL suivante :
Remarque : pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
|---|---|---|---|
MerchantID | ans..30 | M | Identifiant du commerçant, attribué par BNP. Ce paramètre doit également être transféré non chiffré. |
PayID | an32 | M | ID attribuée par plateforme de paiement pour le paiement à créditer |
TransID | ans..64 | M | ID de la transaction qui doit être univoque pour chaque paiement |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a..3 | M | Code pour la devise, trois caractères DIN / ISO 4217 |
OrderDesc | ans..768 | OC | Description des marchandises remboursées, prix unitaires, commentaires du commerçant etc. |
| ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
Paramètres pour les notes de crédit des paiements giropay
Le tableau ci-dessous décrit les paramètres de réponse de plateforme de paiement :
Paramètre | Format | CND | Description |
|---|---|---|---|
MID | ans..30 | C | Identifiant du commerçant, attribué par BNP |
PayID | an32 | M | ID attribuée au paiement par plateforme de paiement, par ex. pour le référencement au sein des fichiers batch. |
XID | an32 | M | ID attribuée par plateforme de paiement pour toutes les différentes transactions (autorisation, capture, note de crédit) pour un paiement |
TransID | ans..64 | M | Numéro de transaction du commerçant |
Status | a..30 | M | OK ou FAILED ou AUTHORIZE_REQUEST |
Description | ans..1024 | M | Détails supplémentaires en cas d'échec du paiement. Veuillez ne pas utiliser le paramètre Description mais bien le paramètre Code pour une analyse de l'état de la transaction ! |
Code | n8 | M | Code d'erreur conformément au fichier Excel des codes de réponse de la plateforme de paiement (partie du logiciel Client) |
RefNr | ans..40 | O | Numéro de référence univoque du commerçant. Seuls les caractères a-zA-Z0-9,-_ sont autorisés. |
ErrorText | ans..128 | O | Message d'erreur PPRO détaillé Remarque : n'est retourné que si l'état = FAILED. Utilisation possible uniquement après concertation avec le Support. |
Paramètres de résultat pour les notes de crédit des paiements giropay
Traitement Batch via l'interface
Pour de plus amples informations sur l'utilisation des fichiers Batch et sur leur structure, voir le manuel Batch Manager.
Cette section décrit les paramètres qui doivent être transmis au sein de l'enregistrement (Record) pour l'exécution d'un paiement giropay, ainsi que les informations pouvant être contenues dans le fichier de réponse sur l'état du paiement.
Le tableau ci-dessous donne une vue d'ensemble de toutes les versions batch possibles pour une action spécifique et de leurs particularités :
Action | Version | Description |
|---|---|---|
Note de crédit | 1.0 / 2.0 | Version standard sans retour de code de paramètre |
| 1.x / 2.x | Avec RefNr (valide pour toutes les versions autres que 1.0) |
Description des versions batch possibles
La structure devant être introduite pour un paiement giropay au sein d'un fichier Batch est comme suit :
HEAD,<MerchantID>,<Date>,<Version> GIROPAY,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID> FOOT,<CountRecords>,<SumAmount> |
Exemple de Master MID Funktion:
| HEAD,[Master]MerchantID,Date,2.x Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action) FOOT,CountRecords,SumAmount |
Le tableau ci-dessous décrit les différents champs et valeurs utilisés dans l'enregistrement (record) au sein du fichier batch :
Paramètre | Format | CND | Description |
|---|---|---|---|
Type | a..11 | M | HEAD pour l'en-tête, FOOT pour le pied de page, GIROPAY pour giropay |
Action | a..20 | M | Le paramètre Action définit le type de transaction : note de crédit |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Code pour la devise, trois caractères DIN / ISO 4217 |
TransID | ans..64 | M | ID de la transaction qui doit être univoque pour chaque paiement |
RefNr | ans..40 | O | Numéro de référence univoque du commerçant. Seuls les caractères a-zA-Z0-9,-_ sont autorisés. |
PayID | an32 | M | ID pour cette transaction attribuée par plateforme de paiement |
Description des champs au sein de l'enregistrement pour les fichiers Batch
La zone Record dans le fichier de réponse pour les transactions Batch se présente comme suit :
HEAD,<MerchantID>,<Date>,<Version> GIROPAY,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code> FOOT,<CountRecords>,<SumAmount> |
Le tableau ci-dessous décrit les paramètres de réponse que le Batch Manager sauvegarde dans la zone Record pour chaque transaction (les paramètres par défaut non détaillés ici tels que <TransID> ou <RefNR>, ainsi que les paramètres de demande sont retournés inchangés et correspondent à l'appel tel que spécifié) :
Paramètre | Format | CND | Description |
|---|---|---|---|
Action | a..20 | M | Le paramètre Action définit le type de transaction : Note de crédit |
PayID | an32 | M | ID pour cette transaction attribuée par plateform de paiement |
Status | a..50 | M | OK ou FAILED |
Code | n8 | M | Code d'erreur conformément au fichier Excel des codes de réponse de la plateforme de paiement (partie du logiciel Client) |
Description des paramètres de résultat au sein de l'enregistrement pour les fichiers Batch