Sips Dictioaire des doées Versio 2.01 Octobre 2010 1/63
Sommaire 1. INTRODUCTION... 5 2. DESCRIPTION DES CHAMPS... 6 ACCOUNT_ID... 6 ACCOUNT_SERIAL... 6 ADVERT... 6 AMOUNT... 6 AUTHORISATION_ID... 6 AUTHORISED_AMOUNT... 6 AUTOMATIC_RESPONSE_STATUS... 6 AUTOMATIC_RESPONSE_URL... 7 AVS_RESPONSE_CODE... 7 BACKGROUND_ID... 7 BANK_NUMBER... 7 BANK_RESPONSE_CODE... 7 BGCOLOR... 7 BLOCK_ALIGN... 8 BLOCK_ORDER... 8 BROWSER_TYPE... 8 CADDIE... 8 CANCEL_RETURN_LOGO... 8 CANCEL_RETURN_URL... 8 CAPTURE_DATE... 9 CAPTURE_DAY... 9 CAPTURE_MODE... 9 CARD_LIST... 9 CARD_NUMBER... 9 CARD_NUMBER_FORMAT... 9 CARD_TYPE... 9 CARD_VALIDITY... 10 CERTIFICATE_DATE... 10 CERTIFICATE_EXPIRED... 10 CERTIFICATE_TYPE... 10 CERTIFICATE_VERSION... 10 CHEQUE_AMOUNT... 10 CHEQUE_CMC7_BANK_ZONE... 10 CHEQUE_CMC7_CHEQUE_NUMBER... 10 CHEQUE_CMC7_INTERNAL_ZONE... 10 CHEQUE_CURRENCY_CODE... 11 CHEQUE_FNCI_MSG... 11 CHEQUE_FNCI_RESPONSE... 11 CHEQUE_GUARANTEE_MSG... 11 CHEQUE_GUARANTEE_NUMBER... 11 CHEQUE_GUARANTEE_RESPONSE... 11 CHEQUE_PAYMENT_DATE... 12 CHEQUE_PAYMENT_TIME... 12 CHEQUE_TRACK_TYPE... 12 CHEQUE_TRANSACTION_ID... 12 COMPLEMENTARY_CODE... 12 COMPLEMENTARY_INFO... 13 CREDIT_AMOUNT... 13 CURRENCY_CODE... 13 CURRENT_AMOUNT... 13 2/63
CUSTOMER_EMAIL... 13 CUSTOMER_ID... 14 CUSTOMER_IP_ADDRESS... 14 CUSTOMER_PWD... 14 CUSTOMER_NEWPWD... 14 CVV_KEY... 14 CVV_RESPONSE_CODE... 15 DATA... 15 DIAGNOSTIC_CERTIFICATE... 15 DIAGNOSTIC_CODE... 15 DIAGNOSTIC_DATE... 15 DIAGNOSTIC_TIME... 15 FROM_PAYMENT_DATE... 15 FROM_TRANSACTION_DATE... 15 FROM_TRANSACTION_ID... 16 HEADER_FLAG... 16 LANGUAGE... 16 LAST_OPERATION_CODE... 16 LAST_OPERATION_DATE... 16 LOGO_ID... 16 LOGO_ID2... 16 MERCHANT_COUNTRY... 17 MERCHANT_ID... 17 MERCHANT_LANGUAGE... 17 MERCHANT_NAME... 17 MERCHANT_URL... 17 MERCHANT_URL_RETURN... 17 MERCHANTWALLET_ID... 17 MERCHANTWALLET_PASSWORD... 18 MPI_CAVV... 18 MPI_CAVV_ALGORITHM... 18 MPI_ECI... 18 MPI_TX_STATUS... 18 MPI_XID... 18 NEW_AMOUNT... 18 NEW_STATUS... 19 NORMAL_RETURN_LOGO... 19 NORMAL_RETURN_URL... 19 O3D_OFFICE_URL_ACS... 19 O3D_RESPONSE_CODE... 19 O3D_SESSION_ID... 19 OPERATION_CERTIFICATE... 19 OPERATION_DATE... 20 OPERATION_TIME... 20 ORDER_CHANNEL... 20 ORDER_ID... 20 ORDER_VALIDITY... 20 ORIGIN... 20 ORIGIN_AMOUNT... 21 PAYID_RESPONSE_CODE... 21 PAYID_TYPE... 21 PAYMENT_CERTIFICATE... 21 PAYMENT_DATE... 21 PAYMENT_MEANS... 21 PAYMENT_PATTERN... 21 PAYMENT_TIME... 22 3/63
PIN_CODE... 22 PP_OPERATOR... 22 PRIVATE_DIAG_DATA... 22 RECEIPT_COMPLEMENT... 22 RECORD_SEQUENCE... 22 RESPONSE_CODE... 22 RETURN_CONTEXT... 23 SECURITY_INDICATOR... 23 SERVICE_TYPE... 23 SESSION_ID... 23 STATEMENT_REFERENCE... 23 STATUS... 23 SUBMIT_LOGO... 24 TARGET... 24 TEMPLATEFILE... 24 TEXTCOLOR... 24 TEXTFONT... 25 TRANSACTION_CERTIFICATE... 25 TRANSACTION_CONDITION... 25 TRANSACTION_DATE... 25 TRANSACTION_ID... 25 TRANSACTION_STATUS... 25 TRANSACTION_TIME... 26 TRANSMISSION_DATE... 26 UPAN... 26 VERSION... 26 3. LISTE DES ANNEXES... 27 ANNEXE A : CHAMPS PRESENTS SUR LES INTERFACES... 27 ANNEXE B : TABLEAU DES CODES DEVISE... 31 ANNEXE C : ETAT D ENVOI DE LA REPONSE AUTOMATIQUE... 32 ANNEXE D : AVS (ADRESS VERIFICATION SERVICE)... 33 ANNEXE E : LISTE DES CARTES ACCEPTEES... 34 ANNEXE F : CODE REPONSE BANCAIRE... 37 ANNEXE G : DATE D ENVOI EN BANQUE D UNE TRANSACTION... 39 ANNEXE H : CODE REPONSE INTEROGATION CHEQUE FNCI... 40 ANNEXE I : CODE REPONSE GARANTIE CHEQUE FNCI... 41 ANNEXE J : CODE REPONSE COMPLEMENTAIRE... 42 ANNEXE K : NUMERO DE CONTROLE (CRYPTOGRAMME)... 43 ANNEXE L : LE FORÇAGE D UNE TRANSACTION... 45 ANNEXE M : VALEURS DU CHAMP DIAGNOSTIC_CODE... 46 ANNEXE N : LISTE DES LANGUES ACCEPTEES... 47 ANNEXE O : CODE DES OPERATIONS... 48 ANNEXE P : LISTE DES CODES PAYS... 49 ANNEXE Q : 3-D SECURE... 50 ANNEXE R : CYCLE DE VIE D UNE TRANSACTION... 53 ANNEXE S : CODE REPONSE SERVER 3D OFFICE... 54 ANNEXE T : TYPE DE PAIEMENT... 55 ANNEXE U : CODE REPONSE SIPS... 56 ANNEXE V : RESULTAT DE L AUTHENTIFICATION DU PAIEMENT... 58 ANNEXE W : MODALITES D ENVOI EN BANQUE... 59 ANNEXE X : LE PAIEMENT EN PLUSIEURS FOIS... 60 ANNEXE Y : LE REJEU D UNE TRANSACTION... 62 ANNEXE Z : CODIFICATION OPTIONS DANS CHAMP DATA... 63 4/63
1. INTRODUCTION Ce documet décrit toutes les caractéristiques des champs présets das les différetes iterfaces Sips. Covetios d écriture Afi d accéder le plus rapidemet possible aux iformatios écessaires à l utilisatio d u champ de l API, toutes les caractéristiques des champs sot décrites suivat le même modèle. Nom du champ das les structures d appel et de répose Nom des différetes iterfaces das lesquelles le champ est préset. Nom du champ das les fichiers de paramétrage parmcom. Si le champ e peut être trasmis qu e dyamique ou si c est u champ dispoible uiquemet das la répose, cette lige sera reseigée à «o préset» Type de caractères acceptés das ce champ. Le type est spécifié par la combiaiso des lettres a, et s correspodat à : a : caractère alphabétique. : caractère umérique. s : caractère spécial. U champ de format a acceptera doc des caractères alphaumériques. Deux possibilités pour la taille du champ : Jusqu à X caractères : champs de taille variable X caractères : champs de taille fixe Descriptio de la foctioalité du champ das l API Das tout le reste du documet, les covetios d écriture suivates serot utilisées : Les revois à d autres documetatios serot otés e majuscules et e italique. ex : GUIDE DE PERSONNALISATION DES PAGES Les champs de l API serot otés e gras. ex : amout 5/63
2. DESCRIPTION DES CHAMPS accout_id Sips Office Batch, Sips Office Server (composat Office) jusqu à 10 caractères Cotiet l idetifiat du compte de l iteraute pour ue demade d autorisatio ELV. accout_serial Sips Office Server (composat Office) a jusqu à 24 caractères Cotiet le uméro de série du compte virtuel associé au chèque cadeau. advert Sips Paymet Web ADVERT as jusqu à 32 caractères Cotiet le om de fichier d ue baière affichée au cetre e haut des pages de paiemet. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. amout Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout et PayId, CashMaagemet) jusqu à 12 caractères (miimum 3 caractères) Cotiet le motat de la trasactio. Le motat doit être trasmis das la plus petite uité de la devise. Exemple pour l Euro : u motat de 10,50 Euros doit être trasmis sous la forme 1050. Pour les autres devises, voir le tableau de l aexe B. authorisatio_id Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout et PayId) a jusqu à 10 caractères Cotiet l idetifiat d autorisatio retouré par la baque si la demade d autorisatio est acceptée. Lors d ue opératio de forçage, ce champ cotiet l idetifiat d autorisatio fouri lors de l appel téléphoique du commerçat au cetre d appel referral de sa baque. authorised_amout Sips Office Server (composat Office) jusqu à 12 caractères (miimum 3 caractères) Cotiet le motat autorisé suite à ue demade d autorisatio chèque cadeau. automatic_respose_status a Sips Office Server (composat Diag) jusqu à 15 caractères Cotiet l état de l evoi de la répose automatique au serveur commerçat pour ue trasactio créée à l aide de l iterface Sips Paymet Web. Pour coaître les différets états de l evoi de la répose automatique, référez-vous à l aexe C. 6/63
automatic_respose_url Sips Paymet Web AUTO_RESPONSE_URL as jusqu à 511 caractères Cotiet l URL du commerçat pour l evoi de la répose automatique, à la fi d ue trasactio. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DU PROGRAMMEUR de l iterface Sips Paymet Web. avs_respose_code Sips Office Batch, Sips Office Server (composat Office, Checkout) 2 caractères Champ revoyé das la répose das le cas d ue demade d autorisatio d u porteur britaique chez u commerçat britaique. Pour coaître la compositio et la sigificatio de ce champ, veuillez vous référer à l aexe D. backgroud_id Sips Paymet Web BACKGROUND as jusqu à 32 caractères Cotiet le om de l image e fod d écra des pages de paiemet. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. bak_umber Sips Office Batch, Sips Office Server (composat Office) 8 caractères Cotiet le code baque associé au compte de l iteraute pour ue demade d autorisatio ELV. bak_respose_code Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, CheckOut, PayId, CashMaagemet) 2 caractères Champ revoyé das la répose et coteat le code de la répose du serveur d autorisatio bacaire. Pour coaître la valeur des différets codes et leur sigificatio, référez-vous à l aexe F. bgcolor Sips Paymet Web BGCOLOR a 7 caractères Cotiet le code couleur RGB commeçat par # du fod d écra des pages de paiemet. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. 7/63
block_alig Sips Paymet Web BLOCK_ALIGN a jusqu à 12 caractères Cotiet la valeur left, ceter ou right. Ce champ précise la positio de la phrase de commetaire précédat les logos des moyes de paiemet et la positio des logos des moyes de paiemet affichés par l API. Par défaut, ce champ est iitialisé à ceter. Pour plus d iformatios, vous devez vous référer au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. block_order BLOCK_ORDER Sips Paymet Web s jusqu à 32 caractères Cotiet l ordre d affichage des blocs de paiemet (logo(s) et phrase de commetaire associée) affichés par l API. Par défaut, ce champ est iitialisé à 1,2,3,4,5,6,7,8,9. Pour plus d iformatios, vous devez vous référer au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. browser_type Sips Paymet Web as jusqu à 128 caractères o utilisé caddie Sips Paymet Web CADDIE as jusqu à 2048 caractères Champ libre. Toute iformatio trasmise das ce champ par le commerçat lors de la requête de paiemet est revoyée das la répose sas modificatio. cacel_retur_logo Sips Paymet Web CANCEL_LOGO as jusqu à 50 caractères Cotiet le om de fichier du logo représetat le bouto «ANNULATION RETOUR A LA BOUTIQUE» affiché sur la page de saisie du uméro de carte et sur la page de répose e cas de refus de la trasactio. Si ce champ est pas reseigé, u bouto par défaut sera affiché. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. cacel_retur_url Sips Paymet Web CANCEL_URL as jusqu à 511 caractères Cotiet l URL du commerçat pour le retour à la boutique e cas d aulatio de la trasactio de la part de l iteraute ou e cas de refus de la trasactio. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DU PROGRAMMEUR de l iterface Sips Paymet Web. 8/63
capture_date Sips Office Server (composat Diag) (aaaammjj) 8 caractères Cotiet la date d evoi e baque de la trasactio. Pour plus d iformatio sur ce champ référez-vous à l aexe G. capture_day Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout et PayId) CAPTURE_DAY jusqu à 2 caractères Cotiet le ombre de jours avat l evoi e baque de la trasactio. Pour plus d iformatios, vous devez vous référer à l aexe W. capture_mode Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout et PayId) CAPTURE_MODE a jusqu à 20 caractères Cotiet le mode d evoi e baque de la trasactio. Pour plus d iformatios, vous devez vous référer à l aexe W et X. card_list Sips Paymet Web CARD_LIST as jusqu à 128 caractères o utilisé card_umber Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout et PayId) s 21 caractères maximum pour ue requête, 7 caractères pour ue répose Das le cas d ue demade d autorisatio, ce champ doit coteir le uméro de carte sur lequel la demade d autorisatio sera effectuée. Das le cas d ue répose à ue demade d autorisatio, ce champ cotiet le uméro de carte partiel de l iteraute suivat le format xxxx.yy. xxxx sot les quatre premiers chiffres de la carte et yy les deux deriers. card_umber_format Sips Office Server (composat PayId) 1 Spécifie la faço dot les uméros de carte doivet être masqués 0 : format 1234XXXXXXXXXX67 = afficher les 4 premiers et les 2 deriers chiffres 1 : format XXXXXX789123456XX = masquer les 6 premiers et le derier chiffres Valeur par défaut : 0 card_type Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout et PayId) a 20 caractères Cotiet le type de carte. Pour coaître la liste des cartes acceptées, vous devez vous référer à l aexe E. 9/63
card_validity Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout et PayId) N (aaaamm) 6 caractères Cotiet la date de validité de la carte bacaire pour ue opératio de demade d autorisatio. Si la carte e possède pas de date de validité, ce champ doit être vide. certificate_date Sips Paymet Web jusqu à 8 caractères Champ itere reseigé par l API et coteat la date de créatio du certificat. certificate_expired Sips Paymet Web 8 caractères Champ itere reseigé par l API et coteat la date d expiratio du certificat. certificate_type Sips Paymet Web a jusqu à 5 caractères Champ itere reseigé par l API et coteat le type du certificat. certificate_versio Sips Paymet Web as jusqu à 5 caractères Champ itere reseigé par l API et coteat la versio du certificat. cheque_amout Sips Office Server (composat Cheque) jusqu à 12 caractères (miimum 3 caractères) Voir champ amout cheque_cmc7_bak_zoe Sips Office Server (composat Cheque) 12 caractères Cotiet la zoe bacaire de la piste CMC7. cheque_cmc7_cheque_umber Sips Office Server (composat Cheque) 7 caractères Cotiet le uméro du chèque de la piste CMC7. cheque_cmc7_iteral_zoe Sips Office Server (composat Cheque) 12 caractères Cotiet la zoe itere de la piste CMC7. Pour ue trasactio e Euro, le dixième caractère de ce champ doit être u «9». 10/63
cheque_currecy_code Sips Office Server (composat Cheque) 3 caractères Cotiet le code de la devise du chèque. Seuls les chèques e Euros peuvet faire l objet d ue iterrogatio ou d ue garatie. La seule valeur possible pour ce champ est doc 978. cheque_fci_msg Sips Office Server (composat Cheque) as jusqu à 12 caractères Champ revoyé das la répose et coteat le message précisat la sigificatio du champ cheque_fci_respose. Ce champ est reseigé que si la valeur du champ respose_code est «00». Pour coaître les différetes valeurs possibles du champ cheque_fci_msg et leur sigificatio, référez-vous à l aexe H cheque_fci_respose Sips Office Server (composat Cheque) 2 caractères Champ revoyé das la répose et coteat le code de la répose du FNCI. Ce champ est reseigé que si la valeur du champ respose_code est «00». Pour coaître la valeur des différets codes et leur sigificatio, référez-vous à l aexe H. cheque_guaratee_msg Sips Office Server (composat Cheque) as jusqu à 40 caractères Champ revoyé das la répose et coteat le message précisat la sigificatio du champ cheque_guaratee_respose. Ce champ est reseigé que si la valeur du champ respose_code est «00». Pour coaître les différetes valeurs possibles du champ cheque_guaratee_msg et leur sigificatio, référez-vous à l aexe I. cheque_guaratee_umber Sips Office Server (composat Cheque) 6 caractères Champ revoyé das la répose et coteat le uméro de garatie du chèque. Ce champ est reseigé que si la valeur du champ respose_code est «00». Pour coaître les différetes valeurs possibles de ce champ et leur sigificatio, référez-vous à l aexe I. cheque_guaratee_respose Sips Office Server (composat Cheque) 3 caractères Champ revoyé das la répose et coteat le code de la répose de la garatie. Ce champ est reseigé que si la valeur du champ respose_code est «00». Pour coaître la valeur des différets codes et leur sigificatio, référez-vous à l aexe I. 11/63
cheque_paymet_date Sips Office Server (composat Cheque) (aaaammjj) 8 caractères Champ itere reseigé par le composat Cheque coteat la date à laquelle la requête d iterrogatio ou de garatie a été evoyée au serveur Office. Ce champ fait partie de la clé permettat d idetifier de maière uique les trasactios d u commerçat (cf. champ cheque_trasactio_id). cheque_paymet_time Sips Office Server (composat Cheque) (hhmmss) 6 caractères Champ itere reseigé par le composat Cheque coteat l heure à laquelle la requête d iterrogatio ou de garatie a été evoyée au serveur Office. cheque_track_type Sips Office Server (composat Cheque) a jusqu à 4 caractères Ce champ cotiet le type de la piste du chèque. Actuellemet, la seule valeur possible pour ce champ est : cmc7. cheque_trasactio_id Sips Office Server (composat Cheque) jusqu à 6 caractères Cotiet l idetifiat de la trasactio d iterrogatio ou de garatie. Ue trasactio est défiie à l aide d ue clé formée de quatre valeurs : merchat_coutry, merchat_id, cheque_paymet_date et cheque_trasactio_id. Par coséquet, il suffit à u commerçat doé de fourir u cheque_trasactio_id uique sur ue jourée pour chacue des trasactios evoyées au serveur Office pour e assurer l uicité. Si ue trasactio a été effectuée pour u cheque_trasactio_id doé et qu ue ouvelle trasactio est tetée le même jour avec ce même cheque_trasactio_id, le champ respose_code sera reseigé à 94 par le serveur Office. Le code 94 sigifiat que la trasactio existe déjà. complemetary_code Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout et PayId) 2 caractères Champ revoyé das la répose et coteat le code répose complémetaire du serveur Sips. Ce champ est reseigé que si vous avez adhéré à l u des cotrôles locaux complémetaires offert par la solutio Sips. Pour e savoir plus sur les cotrôles locaux complémetaires, cosulter le GUIDE D UTILISATION DES CONTROLES COMPLEMENTAIRES DE LUTTE CONTRE LA FRAUDE. Pour coaître la valeur des différets codes et leur sigificatio, référez-vous à l aexe J. 12/63
complemetary_ifo Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout et PayId) a jusqu à 255 caractères Champ revoyé das la répose et coteat ue iformatio sur le code répose complémetaire du serveur Sips. Ce champ est reseigé que si vous avez adhéré à l u des cotrôles locaux complémetaires offert par la solutio Sips. Pour e savoir plus sur les cotrôles locaux complémetaires, cosulter le GUIDE D UTILISATION DES CONTROLES COMPLEMENTAIRES DE LUTTE CONTRE LA FRAUDE. credit_amout Sips Office Batch, Sips Office Server (composat Office) jusqu à 12 caractères Cotiet le motat du remboursemet qui sera evoyé e baque. Le motat est revoyé das la plus petite uité de la devise. Exemple pour l Euro : u remboursemet de 10,50 Euros sera revoyé sous la forme 1050. Pour les autres devises voir tableau aexe B. currecy_code Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout, PayId, CashMaagemet) CURRENCY 3 caractères Cotiet le code de la devise de la trasactio. Ce code est compatible ISO-IS 4217. La liste des codes des devises acceptées par le serveur Sips est précisée e aexe B. curret_amout Sips Office Server (composat Diag) jusqu à 12 caractères (miimum 3 caractères) Cotiet le motat de la trasactio lors du diagostic. Le curret_amout peut différer de l origi_amout si des opératios ot été réalisées sur la trasactio (aulatio, validatio, ). Le motat est trasmis das la plus petite uité de la devise. Exemple pour l Euro : u motat de 10,50 Euros est trasmis sous la forme 1050 et u motat de 0,10 Euros est trasmis sous la forme 010. Pour les autres devises voir tableau aexe A. customer_email Sips Paymet Web CUSTOMER_EMAIL as jusqu à 128 caractères No utilisé par le serveur, peut coteir l adresse mail de l acheteur. Toute iformatio trasmise das ce champ par le commerçat lors de la requête de paiemet est revoyée das la répose sas modificatio. 13/63
customer_id Sips Paymet Web, Sips Office Server (composat PayId) CUSTOMER_ID as jusqu à 19 caractères Pour le composat PayId, c est le uméro uméro d aboé, idetifiat d utilisateur fial. Das le cas de l iterface Sips Paymet Web, ce champ est libre. Toute iformatio trasmise das ce champ par le commerçat lors de la requête de paiemet est revoyée das la répose sas modificatio. ATTENTION : les caractères suivats, «;», «:» et «"» sot iterdits das le champ customer_id. Si ces caractères sot utilisés, cela etraîera, e démostratio, l apparitio d ue page d erreur verte, tadis qu e productio, tous ces caractères serot remplacés par des blacs. customer_ip_address Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout) s jusqu à 19 caractères Peut coteir l adresse IP de l acheteur. Toute iformatio trasmise das ce champ par le commerçat lors de la requête de paiemet est revoyée das la répose sas modificatio. customer_pwd Sips Office Server (composat PayId) as jusqu à 10 caractères Cotiet u mot de passe devat être cofroté avec le mot de passe stocké e base de doées Sips, pour procéder à la vérificatio de mot de passe. customer_ewpwd Sips Office Server (composat PayId) as jusqu à 10 caractères Cotiet le mot de passe qui doit être stocké par Sips das sa base de doées. cvv_flag Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout, PayId) 1 caractère Champ revoyé das la répose das le cas d u paiemet avec ue carte possédat u uméro de cotrôle. Pour plus d iformatios, vous devez vous référer à l aexe K. cvv_key Sips Office Batch, Sips Office Server (composat Office, Checkout, PayId) 3 ou 4 caractères Das le cas d ue demade d autorisatio, ce champ cotiet le cryptogramme visuel de la carte bacaire. Pour plus d iformatio sur le cryptogramme visuel et coaître la liste des cartes cocerées, vous devez vous référer à l aexe K. 14/63
cvv_respose_code Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout, PayId) a 2 caractères Champ revoyé das la répose das le cas d u paiemet avec ue carte possédat u uméro de cotrôle. Pour plus d iformatios, vous devez vous référer à l aexe K. data Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout, PayId) DATA as jusqu à 2048 caractères Champ composite privé permet au commerçat de trasmettre des doées spécifiques écessaires au traitemet de la trasactio. Du fait de la grade taille, ce champ composite peut coteir plusieurs doées de ature différetes Pour plus d iformatios, vous devez vous référer à l Aexe Z diagostic_certificate Sips Office Server (composat Diag) a 12 caractères Champ revoyé das la répose das le cas d u diagostic. La valeur coteue das ce champ est calculée à partir des paramètres du diagostic et certifie que celui-ci a bie été traité par le serveur Sips. diagostic_code Sips Office Server (composat Diag) 2 caractères Cotiet le code répose de la requête de diagostic du serveur Sips. Pour coaître la valeur des différets codes et leur sigificatio, référez-vous à l aexe M. diagostic_date Sips Office Server (composat Diag) (aaaammjj) 8 caractères Cotiet la date de l opératio de diagostic traitée par le serveur Sips. diagostic_time Sips Office Server (composat Diag) (hhmmss) 6 caractères Cotiet l heure locale du serveur Sips lors du traitemet de l opératio de diagostic. from_paymet_date Sips Office Server (composat Office) (aaaammjj) 8 caractères Voir from_trasactio_date from_trasactio_date Sips Office Batch (aaaammjj) 8 caractères Pour ue opératio de duplicatio, cotiet la date de créatio de la trasactio à dupliquer. 15/63
from_trasactio_id Sips Office Batch, Sips Office Server (composat Office) jusqu à 6 caractères Pour ue opératio de duplicatio, cotiet le trasactio_id de la trasactio à dupliquer. header_flag Sips Paymet Web HEADER_FLAG a jusqu à 3 caractères Ce champ idique si l API doit afficher ou o ue phrase de commetaire au-dessus des logos de moyes de paiemet. Deux valeurs sot acceptées : yes ou o. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES. laguage Sips Paymet Web LANGUAGE a 2 caractères Cotiet le code de la lague utilisée pour l affichage des pages de paiemet. Pour coaître la liste des codes des lagues dispoibles, vous devez vous référer à l aexe N. last_operatio_code Sips Office Server (composat Diag) jusqu à 30 caractères Cotiet le code précisat la derière opératio appliquée à la trasactio diagostiquée. Pour coaître la valeur des différets codes et leur sigificatio, référez-vous à l aexe O. last_operatio_date Sips Office Server (composat Diag) (aaaammjjhhmmss) 14 caractères Cotiet la date et l heure de la derière opératio appliquée à la trasactio diagostiquée. logo_id Sips Paymet Web LOGO as jusqu à 32 caractères Cotiet le om du fichier du logo de la boutique affiché e haut à gauche des pages de paiemet. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. logo_id2 Sips Paymet Web LOGO2 as jusqu à 32 caractères Cotiet le om du fichier du logo de la boutique affiché e haut à droite des pages de paiemet. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. 16/63
merchat_coutry Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout, PayId, CashMaagemet, Cheque) MERCHANT_COUNTRY a 2 caractères Cotiet le code du pays du commerçat. La liste des codes pays utilisés sur le serveur Sips est précisée e aexe P. merchat_id Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout, PayId, CashMaagemet, Cheque) jusqu à 15 caractères La valeur de ce champ est fourie par Sips au commerçat, lors de l iscriptio de sa boutique. Il permet l idetificatio d ue boutique Sips. Il correspod gééralemet au SIRET précédé de 0. merchat_laguage Sips Paymet Web MERCHANT_LANGUAGE a 2 caractères o utilisé merchat_ame Sips Office Server (composat Checkout) a 50 caractères Nom de la boutique du commerçat affichée sur l ACS. merchat_url Sips Office Server (composat Checkout) a 512 caractères URL de la boutique du commerçat affichée sur l ACS. merchat_url_retur Sips Office Server (composat Checkout) a 512 caractères URL de retour vers la boutique du commerçat après le passage par l ACS. Lors du passage sur l ACS, le avigateur est pas e moye de détermier sur quel URL reveir après l authetificatio 3-D Secure de l iteraute. Il est doc idispesable, dès la requête de vérificatio d erôlemet 3-D Secure, de prévoir ce futur retour vers la boutique. merchatwallet_id Sips Office Server (composat CashMaagemet) a 6-8 caractères Numéro d'aboé. Il est idetique au sub_subscriber_id fouri ou reçu lors de l'iscriptio de l'aboé par Subscriptio. Ce uméro désige de faço uique l'aboé visé par l'opératio. 17/63
merchatwallet_password Sips Office Server (composat CashMaagemet) as 8 caractères Mot de passe. Si aucu mot de passe a été défii pour l aboé, e pas fourir le champ ou le fourir à vide. mpi_cavv Sips Office Server (composat Office) as 28 caractères Ce champ est utilisé das le cadre d u paiemet 3-D Secure. Il cotiet la valeur de vérificatio de l authetificatio du porteur. Pour coaître la sigificatio de ce champ, référez-vous à l aexe Q. mpi_cavv_algorithm Sips Office Server (composat Office) 1 caractère Ce champ est utilisé das le cadre d u paiemet 3-D Secure. Il cotiet l idicateur de l algorithme utilisé pour la géératio du CAVV. Pour coaître la sigificatio de ce champ, référez-vous à l aexe Q. mpi_eci Sips Office Server (composat Office) 2 caractères Ce champ est utilisé das le cadre d u paiemet 3-D Secure. Il cotiet l idicateur de commerce électroique. Pour coaître la sigificatio de ce champ, référez-vous à l aexe Q. mpi_tx_status Sips Office Server (composat Office) a 1 caractère Ce champ est utilisé das le cadre d u paiemet 3-D Secure. Il cotiet le résultat de l authetificatio. Pour coaître la sigificatio de ce champ, référez-vous à l aexe Q. mpi_xid Sips Office Server (composat Office) as 28 caractères Ce champ est utilisé das le cadre d u paiemet 3-D Secure. Il cotiet l idetifiat de trasactio uique (gééré par le MPI) préseté das tous les messages 3-D Secure. Pour coaître la sigificatio de ce champ, référez-vous à l aexe Q. ew_amout Sips Office Batch, Sips Office Server (composat Office, Checkout, CashMaagemet) jusqu à 12 caractères (miimum 3 caractères) Cotiet le motat de la trasactio à la fi d ue l opératio. Par exemple, si après avoir effectué ue demade d autorisatio acceptée de 10,00 Euros, u commerçat aule 3,00 Euros, le champ ew_amout à la fi de l aulatio sera de 7,00 Euros. Le motat est trasmis das la plus petite uité de la devise. Exemple pour l Euro : u motat de 10,50 Euros doit être trasmis sous la forme 1050. Pour les autres devises voir tableau aexe B. 18/63
ew_status Sips Office Batch, Sips Office Server (composat Office, Checkout, CashMaagemet) as jusqu à 20 caractères Cotiet l état de la trasactio après ue opératio sur celle-ci. L état d ue trasactio est décrit par différets mots clés évoluat au fil des opératios qu elle subit. Pour plus d iformatio sur les états possibles d ue trasactio, référez-vous à l aexe R. ormal_retur_logo Sips Paymet Web RETURN_LOGO as jusqu à 50 caractères Cotiet le om de fichier du logo représetat le bouto «RETOUR A LA BOUTIQUE» affiché sur la page du ticket répose de la demade d autorisatio. Si ce champ est pas reseigé, u bouto par défaut sera affiché. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. ormal_retur_url Sips Paymet Web RETURN_URL as jusqu à 511 caractères Cotiet l URL du commerçat pour le retour à la boutique e cas d acceptatio de la trasactio. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DU PROGRAMMEUR de l iterface Sips Paymet Web. o3d_office_url_acs Sips Office Server (composat Checkout) a 256 caractères Cotiet l URL de redirectio vers AWL permettat la redirectio de l iteraute sur so ACS das le cadre d ue trasactio 3-D Secure. o3d_respose_code Sips Office Server (composat Checkout) 2 caractères Champ revoyé das la répose et coteat le code répose du serveur 3D Office. Pour coaître la valeur des différets codes et leur sigificatio, référez-vous à l aexe S. o3d_sessio_id Sips Office Server (composat Checkout) a 128 caractères Idetifiat de sessio du paiemet 3-D Secure qui devra être copié das la requête card3d_order ou card3d_autheticate operatio_certificate Sips Office Batch a 12 caractères Champ revoyé das la répose das le cas d ue opératio acceptée. La valeur coteue das ce champ est calculée à partir des élémets de l opératio et certifie que celle-ci a bie été traitée par le serveur Office. 19/63
operatio_date Sips Office Batch (aaaammjj) 8 caractères Date de l opératio operatio_time Sips Office Batch (hhmmss) 6 caractères Heure de l opératio order_chael Sips Office Batch, Sips Office Server (composat Office, Diag) as Jusqu à 15 caractères Ce champ sert à spécifier le caal de commade utilisé (Iteret, Téléphoe, Courrier, Fax, ), iteret est la valeur par défaut. Pour coaître les différetes valeurs de cet idicateur et leur sigificatio, référez-vous à l aexe T. ATTENTION : l'usage de ce champ est soumis à des coditios. Il faut valider avec votre cotact Sips quelles valeurs sot acceptables das votre cas car l usage de ce champ est coditioé par ue mise à jour de votre cotrat d acquisitio qui est lié au type d activité du commerçat (ecommerce, VAD). Exemple : e mode VAD, les programmes 3-D Secure e s appliquet pas et le commerçat e bééficie pas du trasfert de resposabilité e cas de cotestatio du porteur. order_id Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout, PayId, CashMaagemet, Cheque) as jusqu à 32 caractères Cotiet le uméro de commade associé à la trasactio de paiemet. Toute iformatio trasmise das ce champ par le commerçat lors de la requête de paiemet est revoyée das la répose sas modificatio. ATTENTION : les caractères suivats, «;», «:» et «"» sot iterdits das le champ order_id. Si ces caractères sot utilisés, cela etraîera, e démostratio, l apparitio d ue page d erreur verte (sur Sips Paymet Web), tadis qu e productio ou sur les autres iterfaces, tous ces caractères serot remplacés par des blacs. order_validity Sips Paymet Web, Sips Office Server (composat Office, Checkout) VALIDITY 2 caractères o utilisé origi Sips Office Server (composat Office, Checkout, PayId, Cheque) as jusqu à 20 caractères Ce champ peut être utilisé par le commerçat pour préciser l origie d ue opératio (ex : om du programme). Ce champ sera préset das le joural des opératios expédié quotidieemet au commerçat. ATTENTION : les caractères suivats, «;», «:» et «"» sot iterdits das le champ origi. Si ces caractères sot utilisés, tous ces caractères serot remplacés par des blacs. 20/63
origi_amout Sips Office Server (composat Diag) jusqu à 12 caractères (miimum 3 caractères) Cotiet le motat de la trasactio lors de sa créatio. Le motat est trasmis das la plus petite uité de la devise. Exemple pour l Euro : u motat de 10,50 Euros est trasmis sous la forme 1050 et u motat de 0,10 Euros est trasmis sous la forme 010. Pour les autres devises voir tableau aexe A. payid_respose_code Sips Office Server (composat PayId) 2 caractères Champ revoyé das la répose et coteat le code répose du serveur Payid. payid_type Sips Office Server (composat PayId) 1 caractère Das le cas d opératios offrat la possibilité d effectuer u paiemet das la foulée, champ spécifiat si u tel paiemet doit être effectué ou o. paymet_certificate Sips Paymet Web, Sips Office Server (composat Diag) a 12 caractères Champ revoyé das la répose das le cas d ue demade d autorisatio acceptée. La valeur coteue das ce champ est calculée à partir des élémets de la trasactio et certifie que la demade d autorisatio a bie été traitée par Sips. paymet_date Sips Paymet Web, Sips Office Server (composat Office, Diag, Checkout, PayId) (aaaammjj) 8 caractères Champ revoyé das la répose et coteat la date de la demade d autorisatio reseigée par le serveur Sips. paymet_meas Sips Paymet Web, Sips Office Server (composat Diag) PAYMENT_MEANS as jusqu à 128 caractères Das la requête de paiemet, cotiet la liste des moyes de paiemet et le uméro des phrases de commetaires affichés par l API e foctio du moye de paiemet. Das la répose, cotiet le moye de paiemet choisi par l iteraute pour la trasactio. Pour coaître la liste des codes des moyes de paiemet utilisés das l API et leur sigificatio, référez-vous à l aexe E. paymet_patter Sips Office Batch, Sips Office Server (composat Office, Diag) Jusqu à 12 caractères Ce champ sert à spécifier le type de paiemet utilisé (A l'acte, 1 er paiemet récurret, ). Pour coaître les différetes valeurs de cet idicateur et leur sigificatio, référez-vous à l aexe T. 21/63
paymet_time Sips Paymet Web (hhmmss) 6 caractères Champ revoyé das la répose et coteat l heure locale du serveur Sips lors de la demade d autorisatio. pi_code Sips Office Server (composat Office) a 30 caractères Cotiet l idetifiat du chèque cadeau pour ue opératio de demade d autorisatio pp_operator Sips Office Server (composat Office) a jusqu à 20 caractères Cotiet le om de l opérateur techique acceptat les chèques cadeaux. private_diag_data Sips Office Server (composat Diag) a jusqu à 1024 caractères Pour ue trasactio chèque cadeau, cotiet les champs PP_OPERATOR, ACCOUNT_SERIAL et AUTHOR_SESSION aisi que les valeurs associées. Exemple de valeur du champ private_diag_data : "PP_OPERATOR=PROMONETIC;ACCOUNT_SERIAL=000290100000001078000009;AU THOR_SESSION=eiyBJ5azjPXMsv" receipt_complemet Sips Paymet Web RECEIPT as jusqu à 3072 caractères Cotiet des iformatios supplémetaires e lagage HTML qui serot affichées au-dessus de la date de la trasactio sur le ticket de l iteraute (récapitulatif de la commade après acceptatio de la trasactio). Pour plus d iformatios sur l utilisatio de ce champ référezvous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. record_sequece Sips Office Batch 5 caractères Numéro de lige permettat au commerçat de rapprocher la répose à la requête. respose_code Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout, PayId, CashMaagemet, Cheque) 2 caractères Champ revoyé das la répose et coteat le code de la répose du serveur Sips. Pour coaître la valeur des différets codes et leur sigificatio, référez-vous à l aexe U. 22/63
retur_cotext Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Checkout, PayId, CashMaagemet) RETURN_CONTEXT as jusqu à 256 caractères Ce champ peut être utilisé pour retrouver le cotexte de la commade d u acheteur. Toute iformatio trasmise das ce champ par le commerçat lors de la requête de paiemet est revoyée das la répose sas modificatio. ATTENTION : les caractères suivats, «;», «:» et «"» sot iterdits das le champ retur_cotext. Si ces caractères sot utilisés, cela etraîera, e démostratio, l apparitio d ue page d erreur verte, tadis qu e productio, tous ces caractères serot remplacés par des blacs. security_idicator Sips Office Server (composat Office) 2 caractères Ce champ est utilisé das le cadre d u paiemet 3-D Secure. Il décrit le iveau de sécurité de la trasactio. Cet idicateur se calcule e foctio du résultat préalable de l authetificatio 3-D Secure. Pour coaître les différetes valeurs de cet idicateur et leur sigificatio, référez-vous à l aexe Q. service_type Sips Office Server (composat Cheque) 4 caractères Champ revoyé das la répose et coteat le service FNCI appelé. Ce champ peut predre les deux valeurs suivates : 9110 : garatie FNCI. 9310 : cosultatio chèque FNCI sessio_id Sips Office Server (composat Office) a jusqu à 16 caractères Cotiet l idetifiat de sessio de la trasactio chèques cadeaux. statemet_referece Sips Paymet Web STATEMENT_REFERENCE as jusqu à 100 caractères Champ libre. Toute iformatio trasmise das ce champ par le commerçat lors de la requête de paiemet est revoyée das la répose sas modificatio. ATTENTION : les caractères suivats, «;», «:» et «"» sot iterdits das le champ statemet_referece. Si ces caractères sot utilisés, cela etraîera, e démostratio, l apparitio d ue page d erreur verte, tadis qu e productio, tous ces caractères serot remplacés par des blacs. status Sips Office Server (composat PayId) as jusqu à 20 caractères Cotiet l état de la trasactio après ue opératio sur celle-ci. L état d ue trasactio est décrit par différets mots clés évoluat au fil des opératios qu elle subit. Pour plus d iformatio sur les états possibles d ue trasactio, référez-vous à l aexe R. 23/63
submit_logo Sips Paymet Web SUBMIT_LOGO as jusqu à 50 caractères Cotiet le om de fichier du logo représetat le bouto «VALIDER» affiché sur la page de saisie du uméro de carte. Si ce champ est pas reseigé, u bouto par défaut sera affiché. Pour plus d iformatios sur l utilisatio de ce champ référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. target Sips Paymet Web TARGET as jusqu à 32 caractères Cotiet l attribut HTML «TARGET» des lies associés à chaque logo des moyes de paiemet. Das le cas d ue boutique comportat des frames, ce champ peut être utilisé pour idiquer le om de la cellule das laquelle le documet sera affiché. Ce champ peut égalemet predre les trois valeurs HTML suivates : _blak : idique au avigateur qu il doit créer ue ouvelle feêtre afi d afficher les pages de paiemet. _self : idique au avigateur que la page sera chargée das la même frame que celle où se trouvet les logos des moyes de paiemet _top : idique au avigateur que la page sera chargée sur toute la surface de la feêtre du avigateur. Si vous e reseigez pas ce champ, la valeur utilisée par défaut par les avigateurs est _self. ATTENTION : si vous affichez les trois pages de dialogue avec le serveur Sips das ue frame, la petite clé ou le cadeas e bas à gauche du avigateur sera supprimée et u message d'alerte idiquat que les pages e sot pas sécurisées est susceptible d'apparaître. Ceci viet du fait que les pages e sot pas 100% sécurisées, car le site commerçat reste e toile de fod. E réalité, la trasactio se déroule bie sur des pages sécurisées SSL comme à l'ordiaire et il coviedra doc de préveir l'iteraute de e pas teir compte des messages d alerte du avigateur. Ue solutio est evisageable pour e pas perdre la petite clé ou le cadeas : ouvrir ue feêtre supplémetaire pour les trois pages de paiemet à l aide de l attribut _blak ou _top templatefile Sips Paymet Web TEMPLATE as jusqu à 32 caractères Cotiet le om de fichier du template (feuille de style) utilisé pour la persoalisatio des pages de paiemet. Pour plus d iformatios sur l utilisatio de ce champ, référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. textcolor Sips Paymet Web TEXTCOLOR a 7 caractères Cotiet le code couleur RGB commeçat par # du texte affiché sur les pages de paiemet. Si ce champ est pas reseigé, le texte sera affiché e oir. Pour plus d iformatios sur l utilisatio de ce champ et pour avoir des exemples de codes RGB, référez-vous au documet GUIDE DE PERSONNALISATION DES PAGES de l iterface Sips Paymet Web. 24/63
textfot Sips Paymet Web TEXTFONT a 64 caractères o utilisé trasactio_certificate Sips Office Batch, Sips Office Server (composat Office, Checkout, PayId, CashMaagemet, Cheque) a 12 caractères Champ revoyé das la répose das le cas d ue opératio acceptée. La valeur coteue das ce champ est calculée à partir des élémets de l opératio et certifie que celle-ci a bie été traitée par le serveur Sips. trasactio_coditio Sips Paymet Web CONDITION as 64 caractères Cotiet le résultat de l authetificatio du paiemet. La liste des valeurs retourées par le serveur Sips est précisée e Aexe V trasactio_date Sips Office Batch, Sips Office Server (composat Office, Checkout, PayId, CashMaagemet, Cheque) (aaaammjj) 8 caractères Champ revoyé das la répose et coteat la date de l opératio traitée par le serveur Sips. trasactio_id Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout, PayId, CashMaagemet) jusqu à 6 caractères Cotiet l idetifiat de la trasactio de paiemet. Ue trasactio est défiie à l aide d ue clé formée de quatre valeurs : merchat_coutry, merchat_id, paymet_date et trasactio_id. Par coséquet, il suffit à u commerçat doé de fourir u trasactio_id uique sur ue jourée pour chacue des trasactios de so site web pour assurer l uicité de ses trasactios. E cas de rejeu d ue trasactio existate, ue page d erreur est affichée. Pour plus d iformatios sur les cas de rejeu de trasactio, référez-vous à l aexe Y. Das chaque API il existe ue foctio qui permet de géérer u trasactio_id basé sur l heure de la trasactio (hhmmss). Pour plus d iformatios sur cette foctio référez-vous au GUIDE DU PROGRAMMEUR de votre API. trasactio_status Sips Office Server (composat Diag) as jusqu à 20 caractères Cotiet l état de la trasactio lors du diagostic. L état d ue trasactio est décrit par différets mots clés évoluat au fil des opératios qu elle subit. Pour plus d iformatio sur les états possibles d ue trasactio, référez-vous à l aexe R. 25/63
trasactio_time Sips Office Batch, Sips Office Server (composat Office, Checkout, PayId, CashMaagemet, Cheque) (hhmmss) 6 caractères Champ revoyé das la répose et coteat l heure locale du serveur Sips lors du traitemet de l opératio. trasmissio_date Sips Paymet Web, Sips Office Server (composat Office, Diag, Checkout, PayId, Cheque) (aaaammjjhhmmss) 14 caractères Champ itere reseigé par l API, revoyé das la répose et coteat la date et l heure GMT (Greewich Mea Time) à laquelle l API a été appelée par l iteraute pour iitialiser sa trasactio. upa Sips Office Batch a A défiir Idetifiat calculé du moye de paiemet utilisé. Champ o reseigé, préset pour u futur usage versio Sips Paymet Web, Sips Office Batch, Sips Office Server (composat Office, Diag, Checkout, PayId, Cheque) a 5 caractères Champ itere reseigé par l API et coteat le uméro de versio de l API. 26/63
Cheque CashMaagemet PayId Checkout Diag Office Sips Office Batch Sips Paymet Web Sips - Dictioaire des doées 3. LISTE DES ANNEXES ANNEXE A : CHAMPS PRESENTS SUR LES INTERFACES Das ce tableau sot présetés les différets champs présets das la solutio Sips et les différetes iterfaces où il est possible de retrouver ces champs. Sips Office Server accout_id accout_serial advert amout authorisatio_id authorised_amout automatic_respose_status automatic_respose_url avs_respose_code backgroud_id bak_umber bak_respose_code bgcolor block_alig block_order browser_type caddie cacel_retur_logo cacel_retur_url capture_date capture_day capture_mode card_list card_umber card_umber_format card_type card_validity certificate_date certificate_expired certificate_type certificate_versio 27/63
Cheque CashMaagemet PayId Checkout Diag Office Sips Office Batch Sips Paymet Web Sips - Dictioaire des doées Sips Office Server cheque_amout cheque_cmc7_bak_zoe cheque_cmc7_cheque_umber cheque_cmc7_iteral_zoe cheque_currecy_zoe cheque_fci_msg cheque_fci_respose cheque_guaratee_msg cheque_guaratee_umber cheque_guaratee_respose cheque_paymet_date cheque_paymet_time cheque_track_type cheque_trasactio_id complemetary_code complemetary_ifo credit_amout currecy_code curret_amout customer_email customer_id customer_ip_address customer_ewpwd customer_pwd cvv_flag cvv_key cvv_respose_code data diagostic_certificate diagostic_code diagostic_date diagostic_time from_paymet_date from_trasactio_date from_trasactio_id header_flag laguage last_operatio_code 28/63
Cheque CashMaagemet PayId Checkout Diag Office Sips Office Batch Sips Paymet Web Sips - Dictioaire des doées Sips Office Server last_operatio_date logo_id logo_id2 merchat_coutry merchat_id merchat_laguage merchat_ame merchat_url merchat_url_retur merchatwallet_id merchatwallet_password mpi_cavv mpi_cavv_algorithm mpi_eci mpi_tx_status mpi_xid ew_amout ew status ormal_retur_logo ormal_retur_url o3d_office_url_acs o3d_respose_code o3d_sessio_id operatio_certificate operatio_date operatio_time order_chael order_id order_validity origi origi_amout payid_respose_code payid_type paymet_certificate paymet_date paymet_meas paymet_patter paymet_time 29/63
Cheque CashMaagemet PayId Checkout Diag Office Sips Office Batch Sips Paymet Web Sips - Dictioaire des doées Sips Office Server pi_code pp_operator private_diag_data receipt_complemet record_sequece respose_code retur_cotext security_idicator service_type sessio_id statemet_referece status submit_logo target templatefile textcolor textfot trasactio_certificate trasactio_coditio trasactio_date trasactio_id trasactio_status trasactio_time trasmissio_date upa versio 30/63
ANNEXE B : TABLEAU DES CODES DEVISE Afi de mieux compredre commet reseiger les champs amout et credit_amout, le tableau cidessous présete, pour chaque devise acceptée par Sips, u exemple de motat aisi que la valeur à trasmettre das les champs amout et credit_amout. L uité fractioaire, metioée das ce tableau, correspod au ombre de décimales de la moaie. Nom de la devise Code de la devise (champ currecy_code) Uité fractioaire Motat Champ amout Euro 978 2 106,55 10655 Dollar Américai 840 2 106.55 10655 Frac Suisse 756 2 106,55 10655 Livre Sterlig 826 2 106.55 10655 Dollar Caadie 124 2 106.55 10655 Ye 392 0 106 106 Peso Mexicai 484 2 106.55 10655 Nouvelle Livre Turque 949 2 106.55 10655 Dollar Australie 036 2 106.55 10655 Dollar Néo-Zéladais 554 2 106.55 10655 Couroe Norvégiee 578 2 106.55 10655 Real Brésilie 986 2 106.55 10655 Peso Argeti 032 2 106.55 10655 Riel 116 2 106.55 10655 Dollar de Taiwa 901 2 106.55 10655 Couroe Suédoise 752 2 106.55 10655 Couroe Daoise 208 2 106.55 10655 Wo 410 0 106.55 106 Dollar de Sigapour 702 2 106.55 10655 Frac Polyésie 953 0 106.55 106 Frac CFA 952 0 106.55 106 31/63
ANNEXE C : ETAT D ENVOI DE LA REPONSE AUTOMATIQUE Le tableau ci-dessous décrit les valeurs possibles du champ automatic_respose_status pour ue trasactio créée via l iterface Sips Paymet Web. Das le cas d ue trasactio créée via Sips Office Extraet ou le composat Office de l API Sips Office Server, le champ automatic_respose_status est toujours reseigé à UNDEFINED, car aucue répose automatique est paramétrable. AUTOMATIC_RESPONSE_STATUS SENT FAILED UNDEFINED descriptio Répose automatique evoyée au serveur commerçat L evoi de la répose automatique a échoué Aucu evoi de répose automatique a été défii (l URL de la répose automatique est pas reseigé) 32/63
ANNEXE D : AVS (ADRESS VERIFICATION SERVICE) L Address Verificatio System AVS est u outil de prévetio de la fraude mis e place otammet au Royaume Ui. Il s appuie sur les doées umériques de l adresse du porteur de la carte e preat e compte séparémet ceux du code postal de ceux du reste de l adresse. Lorsqu u porteur de carte désire se servir de sa carte de crédit, o lui demade l adresse de facturatio associée. Elle est alors trasmise avec la demade d autorisatio pour que la baque du porteur puisse vérifier la cocordace etre l adresse saisie et celle associée à la carte. Das la demade d autorisatio, l adresse est ecodée e supplémet des doées présetes das le champ data. Pour plus de détails au sujet de commet remplir ce champ, reportez-vous à l aexe E. Le champ avs_respose_code das la répose à la demade d autorisatio Lors de la répose du serveur Sips, le champ avs_respose_code est reseigé comme suit : Le champ est rempli sur 2 chiffres. Le premier chiffre reseige le résultat de la vérificatio pour les umériques de l adresse. Le secod chiffre reseige le résultat de la vérificatio pour les umériques du code postal. Les valeurs employées pour coder ce champ sot les suivates : o 0 Aucue doée avait été fourie ; o 1 Aucue vérificatio a été effectuée ; o 2 La vérificatio a réussi ; o 4 La vérificatio a échoué ; o 8 La vérificatio a réussi que partiellemet. o Par exemple, u code 28 sigifie que les doées de l adresse sot correctes mais que celles du code postal e le sot que partiellemet. 33/63
ANNEXE E : LISTE DES CARTES ACCEPTEES Das le tableau ci-dessous, vous trouverez la liste des cartes acceptées par le serveur Office, la valeur à reseiger das le champ card_type et leur réseau d apparteace. Les cartes marquées d u astérisque (*) ot pas de date de fi de validité. Carte valeur das le champ card_type Réseau d apparteace CB (carte locale FR) CB CB Natioal VISA VISA VISA MASTERCARD MASTERCARD MASTERCARD AMEX AMEX AMEX FINAREF (*) FINAREF FINAREF FNAC (*) FNAC FINAREF CYRILLUS (*) CYRILLUS FINAREF PRINTEMPS (*) PRINTEMPS FINAREF KANGOUROU (*) KANGOUROU FINAREF SURCOUF (*) SURCOUF FINAREF POCKETCARD POCKETCARD FINAREF (utilisé e Belgique) CONFORAMA CONFORAMA FINAREF NUITEA NUITEA CETELEM AURORE (*) AURORE CETELEM PASS (*) PASS CETELEM PASS2 (*) PASS2 S2P PASS3FOIS (*) PASS3FOIS S2P CBPASS CBPASS S2P PEUGEOT PEUGEOT CREDITPAR COFINOGA (*) COFINOGA COFINOGA ACCORD ACCORD ACCORD PLURIEL FRANFINANCE FRANFINANCE 1EUROCOM (*) 1EUROCOM COFIDIS 4ETOILES (*) 4ETOILES COFIDIS COFIDIS_3X (*) COFIDIS_3X COFIDIS PROFILPLUS (*) PROFILPLUS COFIDIS LIBRAVOU (*) LIBRAVOU COFIDIS JCB JCB JCB DINERS DINERS DINERS SOLO (carte locale UK) SOLO Acquéreur UK SWITCH (carte locale UK) SWITCH Acquéreur UK DELTA (carte locale UK) DELTA Acquéreur UK BANCONTACTMISTERCASH (carte locale BE) BANCONTACTMISTERCASH BANKSYS Doées supplémetaires e foctio du moye de paiemet Quelques cartes écessitet des doées supplémetaires pour la demade d autorisatio. das ce cas, ces doées sot trasmises das le champ DATA. Si le formatage du champ data est pas respecté, le champ respose_code sera reseigé à 12 (trasactio ivalide) Acceptatio d u paiemet avec ue carte AURORE Il faut reseiger das le champ DATA la date de aissace et la modalité de règlemet 34/63
DATE_NAISSANCE=aaaammjj, MODE_REGLEMENT=MR_CREDIT Pour plus d iformatios, cosulter le GUIDE D IMPLEMENTATION DES CARTES CETELEM. Acceptatio d u paiemet avec ue carte PASS Il faut reseiger das le champ DATA la date de aissace et la modalité de règlemet DATE_NAISSANCE=aaaammjj; MODE_REGLEMENT_PASS=<modalité> avec modalité = COMPTANT ou CREDIT ou 3FOIS» Acceptatio d u paiemet avec ue carte COFINOGA Cosulter le GUIDE D IMPLEMENTATION DES CARTES COFINOGA Acceptatio d u paiemet avec ue carte COFIDIS Cosulter le GUIDE D IMPLEMENTATION COFIDIS 3 FOIS CB Cosulter le GUIDE D IMPLEMENTATION CARTE 4 ETOILES Cosulter le GUIDE D IMPLEMENTATION CARTE LIBRAVOU Cosulter le GUIDE D IMPLEMENTATION COFIDIS 1EURO.COM Acceptatio d ue carte FINAREF Il faut reseiger le champ DATA de la maière suivate : DATA= "FINAREF_OPERATION=xxxxx" Où xxxxx (sur 5 chiffres) est le CODE_OPCM fourit par FINAREF. Ce code correspod à la modalité de règlemet. Acceptatio d ue carte ACCORD Cosulter le GUIDE D IMPLEMENTATION DES PAIEMENTS BANQUES ACCORD Acceptatio d ue carte FRANFINACE Cosulter le GUIDE D IMPLEMENTATION FRANFINANCE SOLUTION SPRINT SECURE Acceptatio d u paiemet avec ue carte SOLO ou SWITCH (cartes UK) Pour les cartes locales UK, il faut fourir das le champ DATA des doées supplémetaires sur la carte ; ISSUE_NUMEBER ou le START_DATE ISSUE_NUMBER=<issue_value>;START_DATE=aaaamm avec <value> ue doée umérique à u ou deux caractères <aaaamm> date d activatio de la carte Si vous souhaitez reseiger das le champ data les paramètres ISSUE_NUMBER et START_DATE vous devez les séparer par u poit virgule (exemple ISSUE_NUMBER=9;START_DATE=200301). Il y a pas d ordre particulier pour les paramètres ISSUE_NUMBER et START_DATE, le champ data reseigé par «ISSUE_NUMBER=9;START_DATE=200301» aura la même sigificatio que si il est reseigé par «START_DATE=200301;ISSUE_NUMBER=9». 35/63
Optio cotrôle AVS (usage UK) Voir Aexe D pour descriptio foctioelle de l AVS. Pour effectuer le cotrôle AVS, le commerçat doit reseiger das le champ DATA les doées d adresse du titulaire de la carte. AVS;TITLE=<title>;FIRSTNAME=<firstame>;LASTNAME=<lastame>;LINE1=<lie1>;LINE2=<lie2 >;LINE3=<lie3>;CITY=<city>;POSTCODE=<postcode>;COUNTRYCODE=<coutrycode>;CHECK=< check>;/avs; Écrire la balise «AVS;» Reseiger les champs au format «KEYWORD=VALUE;» (voir ci-dessous pour la liste des champs) Écrire la balise «/AVS;» Champ Taille max (caractères) Obligatoire (O/N) TITLE 20 N FIRSTNAME 50 N LASTNAME 50 N LINE1 50 O(*) LINE2 50 N LINE3 50 N CITY 50 N POSTCODE 10 O(*) COUNTRYCODE 3 N CHECK 2 N Le champ CHECK permet de préciser la politique qui sera appliquée pour la vérificatio. Voici les valeurs possibles pour ce champ : 0 Pas de vérificatio ; 1 Si la vérificatio échoue, faire échouer la trasactio 2 Si la vérificatio échoue, e pas modifier le résultat de la trasactio (*) Le seul cas où ces élémets sot obligatoires est lorsque CHECK est fouri avec la valeur 1. Si le champ CHECK est pas reseigé, le comportemet par défaut sera d effectuer ue vérificatio bloquate si des doées AVS sot fouries, sio rie est fait. Ce comportemet est préset pour assurer la compatibilité ascedate, il est coseillé de remplir le champ CHECK. Si la balise «AVS;» est pas trouvée das le champ data, il sera cosidéré qu aucue doée AVS est présete. Si la balise «/AVS;» est pas trouvée alors que «AVS;» l est, la trasactio échouera. Les doées omiatives sot stockées e base de doées si elles sot fouries. 36/63
ANNEXE F : CODE REPONSE BANCAIRE Vous trouverez das les tableaux ci-dessous les pricipaux codes répose revoyés par les serveurs d autorisatios bacaires Carte Bacaire (CB, VISA, MASTERCARD), AMEX et FINAREF. Pour Natwest, Cetelem et JCB, les codes e sot pas revoyés. Le code répose du serveur d autorisatio acquéreur est retouré au commerçat das le champ bak_respose_code Code Sigificatio 00 Trasactio approuvée ou traitée avec succès 02 Cotacter l'émetteur de carte 03 Accepteur ivalide 04 Coserver la carte 05 Ne pas hoorer 07 Coserver la carte, coditios spéciales 08 Approuver après idetificatio 12 Trasactio ivalide 13 Motat ivalide 14 Numéro de porteur ivalide 15 Emetteur de carte icou 30 Erreur de format 31 Idetifiat de l'orgaisme acquéreur icou 33 Date de validité de la carte dépassée 34 Suspicio de fraude 41 Carte perdue 43 Carte volée 51 Provisio isuffisate ou crédit dépassé 54 Date de validité de la carte dépassée 56 Carte absete du fichier 57 Trasactio o permise à ce porteur 58 Trasactio iterdite au termial 59 Suspicio de fraude 60 L'accepteur de carte doit cotacter l'acquéreur 61 Dépasse la limite du motat de retrait 63 Règles de sécurité o respectées 68 Répose o parveue ou reçue trop tard 90 Arrêt mometaé du système 91 Emetteur de cartes iaccessible 96 Mauvais foctioemet du système 97 Échéace de la temporisatio de surveillace globale 98 Serveur idispoible routage réseau demadé à ouveau 99 Icidet domaie iitiateur Tableau 1 : Codes répose serveur Carte Bacaire (CB, VISA, MASTERCARD), d après le protocole CB2A 1.1 37/63
Code Sigificatio 00 Trasactio approuvée ou traitée avec succès 02 Dépassemet de plafod 04 Coserver la carte 05 Ne pas hoorer 97 Échéace de la temporisatio de surveillace globale Tableau 2 : Codes répose serveur AMEX Code Sigificatio 00 Trasactio approuvée 03 Commerçat icou Idetifiat de commerçat icorrect 05 Compte / Porteur avec statut bloqué ou ivalide 11 Compte / porteur icou 16 Provisio isuffisate Commerçat ivalide 20 Code moaie icorrect Opératio commerciale icoue Opératio commerciale ivalide 80 Trasactio approuvée avec dépassemet 81 Trasactio approuvée avec augmetatio capital 82 Trasactio approuvée NPAI 83 Compte / porteur ivalide Tableau 3 : Codes répose serveur FINAREF 38/63
ANNEXE G : DATE D ENVOI EN BANQUE D UNE TRANSACTION La date d evoi e baque est idiquée das le champ capture_date de la répose d u diagostic. Cette date déped de l état de la trasactio, du mode et du délai d evoi e baque paramétré lors de la créatio de la trasactio. Le tableau ci-dessous décrit la valeur du champ capture_date e foctio de l état de la trasactio, du mode et du délai d evoi e baque. Nom de l état CANCELLED CAPTURED CREDITED ENDED EXPIRED REFERRAL REFUSED TO_AUTHORIZE TO_CAPTURE TO_CREDIT TO_REPLAY TO_VALIDATE mode validatio capture > 6j mode validatio capture < 6j mode author_capture > 6j mode author_capture < 6j o reseigé o reseigé o reseigé o reseigé date de la validatio date de la validatio date de créatio + délai de capture date de créatio + délai de capture date de la date de la date de créatio + date de créatio + validatio validatio délai de capture délai de capture o reseigé o reseigé o reseigé o reseigé o reseigé o reseigé o reseigé o reseigé date de créatio +30 jours + délai de validatio date de créatio +30 jours + délai de validatio date de créatio +30 jours + délai de capture date de créatio +30 jours + délai de capture o reseigé o reseigé o reseigé o reseigé date de la validatio date de la validatio date de créatio + délai de validatio date de créatio + délai de validatio date de la validatio date de la validatio date de créatio + délai de validatio date de créatio + délai de validatio date de créatio + délai de capture date de créatio + délai de capture date de créatio + délai de capture date de créatio + délai de capture date de créatio + délai de capture date de créatio + délai de capture 39/63
ANNEXE H : CODE REPONSE INTEROGATION CHEQUE FNCI Vous trouverez das le tableau ci-dessous les valeurs revoyées par Chèque Service lors d ue iterrogatio chèque das les champs cheque_fci_respose et cheque_fci_msg. cheque_fci_respose cheque_fci_msg sigificatio 00 VERT aucue iterdictio 01 ORANGE oppositio sur le compte 02 ROUGE chèque irrégulier 03 BLANC chèque o référecé 04 aboé Chèque Service icorrect 05 erreur serveur FNCI 06 Piste CMC7 icorrecte 07 Idetifiat du cetre iformatique icorrect 08 téléparamétrage valide 09 téléparamétrage ivalide 10 téléparamétrage idispoible 99 autre cas 40/63
ANNEXE I : CODE REPONSE GARANTIE CHEQUE FNCI Vous trouverez das le tableau ci-dessous les valeurs revoyées par Chèque Service lors d ue demade de garatie chèque das les champs cheque_guaratee_respose, cheque_guaratee_msg, cheque_fci_msg, cheque_fci_respose et cheque_guaratee_umber. cheque_guaratee_respose cheque_guaratee _msg cheque_fci_ msg cheque_fci _respoce cheque_ guaratee_ umber 000 = garatie accordée REP. FNCI:VERT SIGN 00 000000 001 = garatie refusée REFUS -ERR. PAS 000000 CMC7 INTERRO FNCI 001 = garatie refusée REFUS - ERR. MT PAS INTERRO FNCI 000000 001 = garatie refusée REP. SIGN 01 000000 FNCI:ORANGE 001 = garatie refusée REP. FNCI:ROUGE SIGN 02 000000 002 = demade o automatique APPEL CENTRE PAS INTERRO FNCI 003 = aboé Chèque Service icorrect ABONNE INCONNU PAS INTERRO FNCI 004 = trasactio iterdite PB PARAMETRAGE PAS INTERRO FNCI 000000 000000 005 = service iterdit pour aboé 006 = accord avec réserve REP. FNCI:BLANC SIGN 03 000000 007 = Idetifiat du cetre iformatique icorrect 010 = service idispoible autre valeur 41/63
ANNEXE J : CODE REPONSE COMPLEMENTAIRE Vous trouverez das le tableau ci-dessous les codes répose complémetaires de lutte cotre la fraude revoyés par le serveur Sips das le champ complemetary_code. Code Cotrôle Sigificatio No reseigé Pas de cotrôle effectué. 00 Tous Tous les cotrôles auxquels vous avez adhérés se sot effectués avec succès 02 Ecours carte La carte utilisée a dépassé l ecours autorisé 03 Liste grise La carte utilisée appartiet à la «liste grise» du commerçat 04 Liste grise codes Liste grise codes postaux KO postaux 05 Bi étrager le BIN de la carte utilisée appartiet à ue plage o référecée das la table des BIN de la plate-forme Sips 06 Bi étrager le uméro de carte 'est pas das ue plage de même atioalité que celle du commerçat 07 e-carte Bleue e-carte Bleue détectée 08 Plage de BIN Plage de BIN KO 09 Pays IP Pays IP icou 10 Pays IP Pays IP iterdit 11 Oppotota Carte das Oppotota 12 Combiaiso pays Combiaiso pays carte/ip iterdite carte/ip iterdite 13 Pays IP ou carte Pays IP ou carte icou icou 14 Carte à autorisatio Carte à autorisatio systématique systématique 15 BIN icou BIN icou (sur le cotrôle de carte à autorisatio systématique) 16 E-cours IP E-cours IP KO 99 Tous le serveur Sips a u recotré u problème lors du traitemet d u des cotrôles locaux complémetaires 42/63
ANNEXE K : NUMERO DE CONTROLE (CRYPTOGRAMME) Das le but de combattre la fraude et particulièremet les géérateurs de vrais-faux uméros de carte, Mastercard, Visa, Carte Bleue, America Express et Fiaref (cartes Kagourou, Club Med, Pritemps et Surcouf) ot choisi d accroître le iveau de sécurité de leurs cartes, e adjoigat u uméro de cotrôle (CVV2 pour VISA et Fiaref, CVC2 pour MASTERCARD, CBN2 pour Carte Bleue, et 4DBC pour America Express) au uméro de ces derières. Pour les cartes CB, VISA et MASTERCARD, le uméro de cotrôle (ou cryptogramme visuel) est ue clé de trois chiffres, calculée par des boites oires à partir des doées de la carte. O le trouve à la suite des 4 deriers chiffres du uméro de la carte sur le paeau sigature au dos des cartes. Pour les cartes America Express et CLUB MED, le uméro de cotrôle (ou code sécurité) est ue clé de quatre chiffres se trouvat sur la face avat de la carte. Pour les KANGOUROU, SURCOUF et PRINTEMPS le uméro de cotrôle (ou cryptogramme visuel) est ue clé de trois chiffres. Si u commerçat est paramétré pour accepter ces uméros de cotrôle, l iteraute pourra le saisir sur la page de saisie du uméro de carte das le cas d u paiemet CB, VISA, MASTERCARD, America Express ou Fiaref. Si vous souhaitez que l iteraute saisisse ces uméros de cotrôle, cotactez le Cetre d assistace Techique. Les iformatios associées au uméro de cotrôle sot véhiculées etre le serveur Sips, le serveur d autorisatio et le serveur du commerçat das trois champs : CVV_FLAG : ce champ umérique idique la présece ou l absece du uméro de cotrôle. Ce champ est reseigé par l iteraute sur la page de saisie du uméro de carte et est trasmis lors de la demade d autorisatio. Il est revoyé das la répose au commerçat. Das le tableau ci-dessous sot présetées les différetes valeurs du CVV_FLAG aisi que leur sigificatio. valeur Sigificatio 0 Le uméro de cotrôle est pas remoté par le commerçat 1 Le uméro de cotrôle est préset 2 Le uméro de cotrôle est préset sur la carte du porteur mais illisible (uiquemet pour les cartes CB, VISA et MASTERCARD) 9 Le porteur a iformé le commerçat que le uméro de cotrôle était pas imprimé sur sa carte (uiquemet pour les cartes CB, VISA, MASTERCARD et FINAREF) Si u commerçat est pas paramétré pour accepter le uméro de cotrôle, la valeur 0 sera systématiquemet trasmise lors de la demade d autorisatio et aucu affichage cocerat le uméro de cotrôle e sera effectué sur la page de saisie du uméro de carte. CVV_KEY : ce champ de quatre caractères umériques cotiet la valeur du uméro de cotrôle. Ce champ est reseigé par l iteraute sur la page de saisie du uméro de carte et est trasmis lors de la demade d autorisatio. Il est obligatoire si le champ CVV_FLAG idique sa présece. 43/63
CVV_RESPONSE_CODE : ce champ alphaumérique cotiet le code retour de la vérificatio du uméro de cotrôle de la baque de l iteraute. Il est revoyé das la répose au commerçat. Das le tableau ci-dessous sot présetées les différetes valeurs du CVV_RESPONSE_CODE aisi que leur sigificatio. Valeur Sigificatio 4E Numéro de cotrôle icorrect 4D Numéro de cotrôle correct 50 Numéro de cotrôle o traité 53 Le uméro de cotrôle est abset de la demade d autorisatio 55 La baque de l iteraute est pas certifiée, le cotrôle a pu être effectué. NO Pas de cryptogramme sur la carte. vide Pour les cartes AMEX, America Express e retoure pas de code répose spécifique à la vérificatio du uméro de cotrôle. Si le code sécurité de la carte est faux, America Express retoure u code 05 das le champ RESPONSE_CODE. vide Pour les cartes FINAREF, Fiaref e retoure pas de code répose spécifique à la vérificatio du uméro de cotrôle. 44/63
ANNEXE L : LE FORÇAGE D UNE TRANSACTION Lorsqu'u iteraute a dépassé le plafod de demade d autorisatio de sa carte, le code répose Sips déped du paramétrage du commerçat sur le serveur Sips. Si le commerçat est autorisé à forcer des trasactios (cf. PRESENTATION FONCTIONNELLE), le respose_code et le bak_respose_code serot tous deux reseigés à 02. Par cotre, si le commerçat est pas autorisé à forcer des trasactios le respose_code sera reseigé à 05 tadis que le bak_respose_code sera reseigé à 02. Lorsqu u commerçat fait du forçage, il doit récupérer les coordoées bacaires de l iteraute pour les commuiquer à so cetre d appel referral (le uméro de téléphoe du cetre d appel est fouri par la baque du commerçat). Si vous souhaitez être paramétré sur le serveur Sips pour forcer des trasactios, cotactez le Cetre d Assistace Techique. 45/63
ANNEXE M : VALEURS DU CHAMP DIAGNOSTIC_CODE Vous trouverez das le tableau ci-dessous les valeurs du champ diagostic_code revoyées par le serveur Sips Office Server sur ue requête de diag diagostic_code Sigificatio 00 diagostic réalisé 12 Trasactio ivalide, vérifier les paramètres trasférés das la requête. 25 Trasactio o trouvée das la base Sips. Vérifier l idetifiat de la trasactio (champ trasactio_id) et la date de créatio de la trasactio (champ paymet_date) que vous avez trasférés das la requête. 40 Foctio o supportée : le diagostic e fait pas partie de la liste des opératios auxquelles vous êtes autorisé sur le serveur Sips. Cotactez le Cetre d assistace Techique. 99 Problème temporaire au iveau du serveur Sips. 46/63
ANNEXE N : LISTE DES LANGUES ACCEPTEES Sips Paymet Web permet l'affichage des pages de paiemet das lagues suivates: Lague Fraçais Allemad Aglais Espagol Italie Code api fr ge e sp it Nous vous ivitos à ous cosulter pour l utilisatio d autres lagues. 47/63
ANNEXE O : CODE DES OPERATIONS Das le tableau ci-dessous, vous trouverez la liste des codes opératios présets das le champ last_operatio_code et leur sigificatio. Codes opératio AUTHOR_BATCH AUTHOR ADVICE CANCEL CREDIT CREDIT_CAPTURE DEBIT_CAPTURE DUPLICATE EXPIRED TRANSACTION VALIDATE CREDIT_HOLDER Sigificatio extractio de la trasactio par les serveurs d Atos Origi pour réaliser ue demade d autorisatio automatique à la fi du délai de capture différée demade d autorisatio réalisée automatiquemet par les serveurs d Atos Origi à la fi du délai de capture différée. Cette opératio fait suite à AUTHOR_BATCH. forçage de la trasactio aulatio partielle ou totale de la trasactio remboursemet partiel ou total de la trasactio evoi e baque de la trasactio à créditer evoi e baque de la trasactio à débiter duplicatio de la trasactio expiratio de la trasactio créatio d ue trasactio validatio d ue trasactio crédit porteur 48/63
ANNEXE P : LISTE DES CODES PAYS Das le tableau ci-dessous, vous trouverez la liste des pricipaux codes pays utilisés das les différetes iterfaces Sips et leur sigificatio. Code be fr de it es e Pays Belgique Frace Allemage Italie Espage Royaume-Ui 49/63
ANNEXE Q : 3-D SECURE Les réseaux iteratioaux MasterCard et Visa ot développé des programmes de sécurisatio des paiemets sur Iteret (SecureCode pour Mastercard et Verified by Visa pour Visa) qui exploitet le même protocole, appelé 3-D Secure. D autres réseaux ot depuis mis e œuvre leurs propres programmes sur la base de ce même protocole 3-D Secure (réseau JCB, réseau Bacotact/Mister Cash, et même le GIE CB e charge du réseau iterbacaire fraçais a iclus le protocole 3-D Secure das le cadre des cotrats VADS etre commerçats et acquéreurs fraçais). Le protocole 3-D Secure et les programmes associés de lutte cotre la fraude sur Iteret, et plus spécifiquemet cotre la répudiatio ijustifiée par les porteurs, s appuiet sur la otio d authetificatio du paiemet à travers ue ciématique e 3 domaies (resposabilité émetteur, iteropérabilité et acquéreur). Ils compreet u volet techique, réglemetaire et fiacier. Cette solutio permet de s assurer que l utilisateur d ue carte e est bie le propriétaire. Si le commerçat le souhaite, il peut foctioer avec la solutio 3-D Secure : das ce cas, les iformatios correspodates doivet être véhiculées das la requête d autorisatio evoyée à Sips qui les trasmettra à la plateforme d autorisatio acquéreur. Voir la PRESENTATION FONCTIONNELLE pour plus d iformatios sur 3-D Secure. Les champs 3-D Secure das la demade d autorisatio Das la cadre du processus 3-D Secure, le champ ommé security_idicator devra être calculé (règle de calcul ci-dessous) e foctio du iveau de sécurité de la trasactio (carte erôlée, authetificatio ). Si ue authetificatio a eu lieu, les iformatios suivates (récupérées das la répose d authetificatio) doivet être égalemet fouries (das la mesure où elles ot été produites lors de l authetificatio, autremet les champs serot laissés vides) : mpi_cavv mpi_cavv_algorithm mpi_eci mpi_tx_status mpi_xid Règles de valorisatio des champs 3D Le champ security_idicator peut predre les valeurs suivates ou être vide : Valeur Sigificatio «09» Pas de sécurisatio 3-D Secure (parfois oté SSL) «21» Porteur o erôlé (répose obteue das le Directory Server) «22» Porteur o erôlé (répose obteue das le cache du Merchat Plug-i) «25» Porteur complètemet authetifié sur l ACS (full 3-D Secure) «26» Porteur partiellemet authetifié sur l ACS (Attempt 3-D Secure) «31» Echec de l authetificatio du porteur «32» Sigature ivalide das la répose de l ACS (PARes with ivalid sigture) «33» Répose de l ACS ivalide (PARes ivalid) «81» Erreur itere au MPI lors du 1er appel au MPI «82» Erreur itere au MPI lors du 2d appel au MPI «84» Répose du Directory Server ivalide (VERes ivalid) 50/63
«85» MPI ijoigable lors du 1er appel au MPI «86» MPI ijoigable lors du 2d appel au MPI «88» Problème réseau «92» Erreur itere du Directory Server «93» Erreur itere de l ACS Pour le commerçat cela se traduit de la maière suivate : Cas gééral Boutiques e participat pas à u programme 3-D Secure ou cartes apparteat pas à u réseau appliquat le protocole 3-D Secure (doc autre que Visa, Mastercard, CB et Bacotact/Mister Cash) : le champ security_idicator sera reseigé à «09» (Pas de sécurisatio 3-D Secure SSL) et les autres champs laissés vides. Cas de problème techique dot l origie est au iveau d u ACS Le champ security_idicator sera reseigé à «93» (Erreur itere à l ACS) et les autres champs serot remplis avec les iformatios issues de l authetificatio (e gééral le champ mpi_tx_status qui vaut alors «U», et parfois u champ mpi_xid) Cas de problème techique dot l origie est au iveau d u Directory Server Le champ security_idicator sera reseigé à «92» (Erreur itere au Directory Server) et les autres champs serot laissés vides. Cas de problème techique dot l origie est pas au iveau d u ACS i d u Directory Server Le champ security_idicator sera reseigé avec la valeur qui correspod (etre «81» et «88») et les autres champs serot laissés vides. Cas d u porteur o erôlé Le champ security_idicator sera reseigé à «21» ou «22» selo l origie de la répose (Directory Server ou cache du Merchat Plug-i) et les autres champs serot laissés vides. Cas d u porteur authetifié complètemet Le champ security_idicator sera reseigé à «25» et tous les champs devrot être remplis (le champ mpi_tx_status valat toujours «Y»). Cas d u porteur authetifié partiellemet Le champ security_idicator sera reseigé à «26» et tous les champs obteus lors de l authetificatio devrot être remplis (le champ mpi_tx_status vaut toujours «A» et seuls les champs mpi_cavv et mpi_cavv_algorithm peuvet être vides et toujours e même temps). Cas d échec d authetificatio Le champ security_idicator sera reseigé avec la valeur qui correspod (etre «31» et «33») et les autres champs serot laissés vides. Le champ mpi_cavv sera toujours trasmis à l idetique après so obtetio lors de l authetificatio. Il s agit de la valeur que le MPI obtiet das le message XML PARes, das le champ «TX.cavv» (champ XML «cavv» iclus das le champ XML «TX»). Le champ mpi_cavv_algorithm sera toujours trasmis à l idetique après so obtetio lors de l authetificatio, das la mesure où le champ mpi_cavv est bie reseigé. Il s agit de la valeur que le MPI obtiet das le message XML PARes, das le champ «TX.cavvAlgorithm» (champ XML «cavvalgorithm» iclus das le champ XML «TX»). 51/63
Le champ mpi_tx_status sera toujours trasmis à l idetique après so obtetio lors de l authetificatio. Il s agit de la valeur que le MPI obtiet das le message XML PARes, das le champ «TX.status» (champ XML «status» iclus das le champ XML «TX»). Le champ mpi_xid sera toujours trasmis à l idetique après so obtetio lors de l authetificatio. Il s agit de la valeur que le MPI obtiet das le message XML PARes, das le champ «TX.xid» (champ XML «xid» iclus das le champ XML «TX»). Le champ mpi_eci sera toujours trasmis à l idetique après so obtetio lors de l authetificatio. Il s agit de la valeur que le MPI obtiet das le message XML PARes, das le champ «TX.eci» (champ XML «eci» iclus das le champ XML «TX»). Notammet, les chiffres «0» (zéro) à gauche e devrot pas être oubliés. A titre d exemple, voici des valeurs que l o recotre pour les réseaux Visa et Mastercard (attetio, ceci est pas exhaustif) : PARes PARes TX.eci TX.Status Visa Mastercard «Y» «02» «05» «A» «01» «06» «N» Aucue valeur Aucue valeur «U» Aucue valeur Aucue valeur Ces iformatios sot extraites des documets produits par les réseaux Visa et Mastercard à destiatio des commerçats implémetat des authetificatios 3-D Secure : «Mastercard Merchat Implemetatio Guide March 2004», page 3-3 «Verified by Visa 70020-01 Merchat Implemetatio Guide v2.0 August 2005», pages 30-31 Note importate : L utilisatio de 3-D Secure pour u commerçat implique pas que ses paiemets serot systématiquemet garatis. Les coditios d applicatio de la garatie de paiemet liée à ue trasactio 3-D Secure sot à détermier auprès de votre baque. 52/63
ANNEXE R : CYCLE DE VIE D UNE TRANSACTION Ue trasactio peut subir u certai ombre de modificatios via le composat Office de l iterface Sips Office Server (cf. PRESENTATION FONCTIONNELLE) ou Sips Office Extraet. Les modificatios qu elle peut subir dépedet de so paramétrage d origie (mode et délai de remise e baque) et des opératios qu elle a déjà subies. Pour défiir, à chaque istat, les futures modificatios qu elle pourra subir, u état est associé à chaque trasactio. La trasitio d u état à u autre est défiie par le diagramme des états préseté page suivate. Ci-dessous est précisée la sigificatio des différets états présets das le diagramme des états. Nom de l état CANCELLED CAPTURED CREDITED ENDED EXPIRED REFERRAL REFUSED TO_AUTHORIZE TO_CAPTURE TO_CREDIT TO_REPLAY TO_VALIDATE WAITING_AUTHOR Sigificatio Trasactio totalemet aulée Trasactio evoyée e baque Trasactio totalemet remboursée Trasactio termiée Trasactio expirée Trasactio e attete de forçage Trasactio refusée Trasactio e attete de demade d autorisatio Trasactio à evoyer e baque pour débiter l iteraute Trasactio à evoyer e baque pour créditer l iteraute Trasactio e attete d ue validatio avec demade d autorisatio Trasactio e attete de validatio Trasactio extraite par les serveurs Sips pour réaliser ue demade d autorisatio automatique à la fi du délai de capture différée Le cycle de vie des trasactios Sips 53/63