Table des matières
eps
Informations générales sur eps
En Autriche, plateforme de paiement prend en charge les virements en ligne avec la norme autrichienne de paiement électronique (EPS, Electronic Payment Standard). Cette norme EPS est un système bien établi de paiement pour l'e-commerce en Autriche, avec garantie de paiement pour les commerçants. L'acheteur peut utiliser la banque en ligne bien connue et fiable de son propre établissement de crédit - comme pour toutes les opérations bancaires en ligne.
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.
En Autriche, le virement en ligne avec eps est très répandu dans l'e-commerce et représente donc un complément intéressant au sein de la gamme des moyens de paiement. D'autre part, le commerçant bénéficie d'une garantie de paiement. |
Vous trouverez de plus amples informations sur la page web d'eps / STUZZA (www.stuzza.at).
Schéma de déroulement du processus
Déroulement du processus eps
Interface plateforme de paiement
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 eps
Pour procéder à un paiement en Autriche avec eps virement en ligne à l'aide d'un formulaire de la plateforme de paiement, 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 eps 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 | M | 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. Seul EUR est autorisé. |
OrderDesc | ans..768 | M | Description des marchandises achetées, des prix unitaires etc. |
AccOwner | ans..50 | M | Nom du titulaire de compte |
IBAN | ans..34 | M | Numéro de compte bancaire international pour SEPA |
BIC | ans..11 | M | Code d'identification de la banque pour SEPA |
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 |
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 pour virements en ligne avec eps
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, ce numéro doit être univoque | |
Status | a..50 | M | OK, AUTHORIZED (URLSuccess) ou FAILED (URLFailure) et 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 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. | |
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 | |
AccOwner | ans..50 | M | Nom du titulaire de compte | |
IBAN | ans..34 | M | Numéro de compte bancaire international pour SEPA | |
BIC | ans..11 | M | Code d'identification de la banque pour SEPA | |
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 eps
Note de crédit avec référence
Les notes de crédit (remboursements) sont possibles via une connexion de serveur à serveur. plateforme de paiement n'autorise que les notes de crédit pour eps qui font référence à une capture 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 | ID du commerçant. 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 |
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 eps
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 | 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..30 | M | OK, AUTHORIZE_REQUEST ou FAILED |
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 plateforme de paiement (partie du logiciel Client) |
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 eps
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 note de crédit de eps, 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 paramètre Code |
| 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 note de crédit de eps au sein d'un fichier Batch est comme suit :
HEAD,<MerchantID>,<Date>,<Version> EPS,Credit,<PayID>,<TransID>,(<RefNr>),<Amount>,<Currency> 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, EPS pour eps |
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> EPS,Credit,<PayID>,<TransID>,(<RefNr>),<Amount>,<Currency>,<Status>,<Code> FOOT,<CountRecords>,<SumAmount> |
e
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 plateforme 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 plateforme de paiement (partie du logiciel Client) |
Description des paramètres de résultat au sein de l'enregistrement pour les fichiers Batch