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