Solutions Paybox Direct et Direct Plus

Les opérations de caisse “Direct”

Autorisation Seule

L’opération effectue une demande d’autorisation de débit au serveur d’autorisation de votre établissement bancaire.
Un exemple complet d’implémentation est disponible au paragraphe Exemple d’implémentations.
TYPE: 00001

Requête

Paramètres Format Requis Commentaire
Identification commerçant VERSION 5 chiffres X Version du protocole
TYPE 00001 X Type d’action à réaliser
SITE 7 chiffres X Numéro de site fourni par la banque
RANG 2 chiffres X Numéro de rang fourni par la banque
CLÉ 8 à 10 caractères X Mot de passe du back-office commerçant
Transaction NUMQUESTION 10 chiffres X Identifiant unique et séquentiel
MONTANT 10 chiffres X Montant
DEVISE 3 chiffres X Devise (monnaie)
RÉFÉRENCE 1 à 250 caractères X Référence commande côté commerçant
Informations Porteur PORTEUR 19 caractères X Numéro de carte du porteur (client) sans espace
DATEVAL Date(MMAA) X Date de fin de validité carte
CVV 3 ou 4 caractères X Cryptogramme visuel situé au dos de la carte bancaire
Autres DATEQ 14 chiffres
JJMMAAAAHHMMSS
X Date et heure d’envoi de la requête
ACQUÉREUR 0 à 16 caractères Parfois Nécessaire lors du choix de certains moyens de paiement
ACTIVITÉ 3 chiffres Provenance du flux. Valeur par défaut : 024 (Demande par Internet)
ARCHIVAGE 12 caractères alphanumériques Référence archivage transmise à la banque du commerçant
DATENAISS Date JJMMAAAA Spécifique COFINOGA
PAYS  vide Si présent, Paybox Direct renvoie le code pays de la carte
PRIV_CODETRAITEMENT  3 chiffres Spécifique SOFINCO (ou carte Partenaire-SOFINCO) ou COFINOGA
SHA-1  vide Si présent, Paybox Direct renvoie l’empreinte de la carte

Réponse
Paramètres :

  • NUMTRANS
  • NUMAPPEL
  • NUMQUESTION
  • SITE
  • RANG
  • AUTORISATION
  • CODEREPONSE
  • COMMENTAIRE

 

Débit (Capture)

L’opération effectue une demande de validation d’une autorisation acceptée. Cette requête permet de « capturer » (confirmer) la transaction réalisée lors de l’autorisation seule. Pour faire référence à la transaction, vous devez réutiliser les variables NUMTRANS et NUMAPPEL transmis en réponse de la demande d’autorisation seule.
TYPE: 00002

Requête

Paramètres Format Requis Commentaire
Identification commerçant VERSION 5 chiffres X Version du protocole
TYPE 00002 X Type d’action à réaliser
SITE 7 chiffres X Numéro de site fourni par la banque
RANG 2 chiffres X Numéro de rang fourni par la banque
CLÉ 8 à 10 caractères X Mot de passe du back-office commerçant
Transaction NUMQUESTION 10 chiffres X Identifiant unique et séquentiel
MONTANT 10 chiffres X Montant
DEVISE 3 chiffres X Devise (monnaie)
NUMTRANS 10 chiffres X Numéro de la transaction créée sur Paybox
NUMAPPEL 10 chiffres X Numéro de la requête gérée sur Paybox
RÉFÉRENCE 1 à 250 caractères X Référence commande côté commerçant
Autres DATEQ 14 chiffres
JJMMAAAAHHMMSS
X Date et heure d’envoi de la requête
ACQUÉREUR 0 à 16 caractères Parfois Nécessaire lors du choix de certains moyens de paiement
ACTIVITÉ 3 chiffres Provenance du flux. Valeur par défaut : 024 (Demande par Internet)
SHA-1  vide Si présent, Paybox Direct renvoie l’empreinte de la carte

Réponse

Paramètres :

  • NUMTRANS
  • NUMAPPEL
  • NUMQUESTION
  • SITE
  • RANG
  • AUTORISATION
  • CODEREPONSE
  • COMMENTAIRE

Autorisation + Capture

L’opération effectue une demande d’autorisation de débit au serveur d’autorisation de votre établissement bancaire, puis une demande de validation de l’autorisation acceptée.
TYPE : 00003
Le paramétrage de cette fonction est identique à Autorisation seule sauf que la variable TYPE vaut 00003.

Crédit

L’opération effectue une demande de recrédit de la carte bancaire paiement de votre client. Cette fonction est utile pour rembourser votre client si vous n’avez pas conservé l’identifiant de la transaction d’autorisation nécessaire à la fonction de remboursement.
TYPE : 00004

Annulation

L’opération effectue l’annulation d’une transaction si toutefois, la transaction a été validée et non remis en banque, c’est-à-dire que le client n’a pas été débité sur son compte bancaire. La fonction ANNULATION permet d’annuler l’envoi à votre banque d’une transaction de débit (capture) ou de crédit réalisée à partir des fonctions suivantes : AUTORISATION, CAPTURE, CREDIT, REMBOURSEMENT.
TYPE : 00005

Requête et réponse
Identique à l’opération Capture en renseignant la variable TYPE = 00005

Vérification de l’existence d’une transaction

L’opération effectue une vérification de l’existence d’une transaction non encore remise en banque.
TYPE : 00011

Requête et Réponse
Identique à l’opération Capture en renseignant la variable TYPE = 00011

Transaction sans demande d’autorisation

L’opération existe pour des raisons historiques. Il est aujourd’hui déconseillé de l’utiliser. On lui préfèrera l’opération « autorisation + capture ».
Contacter le support ou notre service commercial pour de plus amples informations.

Modification du montant d’une transaction

L’opération réalise la modification du montant d’une transaction à la hausse ou à la baisse tant que celle-ci n’est pas remise en banque. Les STATUS de transaction pour lesquels l’opération est possible sont :

  • Autorisé
  • Capturé
  • Crédit
  • Refusé

Requête et Réponse
Identique à l’opération Capture en renseignant la variable TYPE = 00013

Remboursement

L’opération réalise le remboursement d’un paiement validé et remis en banque, donc le client a été débité et le commerçant a été crédité.

Requête et Réponse
Identique à l’opération Capture en renseignant la variable TYPE = 00014

Consultation

L’opération réalise une consultation de l’état de la transaction, par exemple pour vous assurer que l’état Paybox correspond bien à celui enregistré dans votre SI.
L’état de la transaction est fourni en retour via la valeur de STATUS.
TYPE = 00017

Requêtes
Identique à l’opération Capture en renseignant la variable TYPE = 00017

Réponse

Paramètres :

  • NUMTRANS
  • NUMAPPEL
  • NUMQUESTION
  • SITE
  • RANG
  • AUTORISATION
  • CODEREPONSE
  • COMMENTAIRE
  • STATUS