Cette classe doit être utilisée dans vos modèles personnalisés de passage à la caisse. Celle-ci sert à contrôler les détails et paramètres du formulaire de tout le processus de prise de la commande. Les objets de la classe Cart seront également disponibles dans votre modèle de passage à la caisse.

Après votre dernière page du passage à la caisse, vous passez le contrôle au système qui validera toutes les données et enregistrera la commande. Ensuite le contrôle est retourné à l'affichage de la confirmation de commande.

Le formulaire présent à l'étape finale de votre passage à la caisse devra comprendre plusieurs champs. Il faudra vous assurer que les valeurs de ces champs soit bien remplies. Voici la liste des champs qui doivent être présents lors de la dernière étape du passage à la caisse:

• b: ce champ représente votre identificateur de marchand. C'est un numéro unique vous représentant. Normalement, vous devriez vous servir de la méthode Checkout.Form.Begin qui va insérer ce champ automatiquement dans le formulaire.
• Language: ce champ indique dans quelle langue on veut afficher le passage à la caisse. Normalement ce paramètre provient du panier et ne devrait pas être changé puisqu'il représente la langue dans laquelle le client a navigué dans votre site. Vous devriez vous servir de la méthode Checkout.Form.Begin qui va insérer ce champ automatiquement dans le formulaire.
• m: ce champ indique si vous êtes en mode «Aperçu» (1) ou non (0).
• ProfilePassword: ce champ représente le mot de passe que l'utilisateur désire utiliser pour protéger son profil.
• ProfileReuseInfo: ce champ indique si le client désire enregistrer son profil et le réutiliser pour des transactions futures. Pour pouvoir réutiliser le profil, la valeur de ce champ doit être "on" (la valeur par défaut d'une case à cocher qui est cochée), "1" ou "true".
• Payment: ce champ représente la méthode de paiement utilisée. Ce champ est un identificateur numérique propre à votre boutique. Vous devriez utiliser Checkout.Payment.ID et Checkout.Payment.Loop à cette fin. Ce champ est obligatoire.
• Shipping: ce champ représente la méthode d'expédition utilisée. Ce champ est un identificateur numérique propre à votre boutique. Vous devriez utiliser Checkout.Shipping.ID et Checkout.Shipping.Loop à cette fin. Ce champ est obligatoire.
• BillFirstName: ce champ représente le prénom du client pour la facturation. Ce champ est obligatoire.
• BillLastName: ce champ représente le nom du client utilisé pour la facturation. Ce champ est obligatoire.
• BillCompany: ce champ représente le nom de compagnie utilisé pour la facturation.
• BillAddress1: ce champ représente l'adresse du client utilisé pour la facturation. Ce champ est obligatoire.
• BillCity: ce champ représente la ville du client utilisée pour la facturation. Ce champ est obligatoire.
• BillState: ce champ représente la province ou l'état du client utilisé pour la facturation. Ce champ peut être un identificateur numérique si la province ou l'état est entrée dans notre base de données. Utilisez Checkout.State.ID et Checkout.State.Loop à cette fin. Pour connaître le nombre de provinces (ou états) dans notre base de données, utilisez Checkout.State.NbElements. Ce champ est obligatoire.
• BillCountry: ce champ représente le pays du client utilisé pour la facturation. Ce champ est un identificateur numérique. Utilisez Checkout.Country.ID et Checkout.Country.Loop à cette fin. Ce champ est obligatoire.
• BillZIP: ce champ représente le code postal ou le code ZIP du client utilisé pour la facturation. Ce champ est obligatoire.
• BillPhone1: ce champ représente le premier numéro de téléphone du client pour la facturation.
• BillPhone2: ce champ représente le deuxième numéro de téléphone du client pour la facturation.
• BillFax: ce champ représente le numéro de fax du client pour la facturation.
• BillEmail: ce champ représente l'adresse de courriel du client pour la facturation. Ce champ est obligatoire.
• ShipFirstName: ce champ représente le prénom du client pour l'expédition. Ce champ est obligatoire si vous devez expédier un produit.
• ShipLastName: ce champ représente le nom du client utilisé pour l'expédition. Ce champ est obligatoire si vous devez expédier un produit.
• ShipCompany: ce champ représente le nom de compagnie utilisé pour l'expédition.
• ShipAddress1: ce champ représente l'adresse du client utilisé pour l'expédition. Ce champ est obligatoire si vous devez expédier un produit.
• ShipCity: ce champ représente la ville du client utilisée pour l'expédition. Ce champ est obligatoire si vous devez expédier un produit.
• ShipState: ce champ représente la province ou l'état du client utilisé pour l'expédition. Ce champ est un identificateur numérique. Utilisez Checkout.State.ID et Checkout.State.Loop à cette fin. Pour connaître le nombre de provinces (ou états) dans notre base de données, utilisez Checkout.State.NbElements. Ce champ est obligatoire si vous devez expédier un produit.
• ShipCountry: ce champ représente le pays du client utilisé pour l'expédition. Ce champ est un identificateur numérique. Utilisez Checkout.Country.ID et Checkout.Country.Loop à cette fin. Ce champ est obligatoire si vous devez expédier un produit.
• ShipZIP: ce champ représente le code postal ou le code ZIP du client utilisé pour l'expédition. Ce champ est obligatoire si vous devez expédier un produit.
• ShipPhone1: ce champ représente le premier numéro de téléphone du client pour l'expédition.
• ShipPhone2: ce champ représente le deuxième numéro de téléphone du client pour l'expédition.
• ShipFax: ce champ représente le numéro de fax du client pour l'expédition.
• ShipEmail: ce champ représente l'adresse de courriel du client pour l'expédition. Ce champ est obligatoire si vous devez expédier un produit.
• Total: ce champ représente le montant des produits achetés (sans les taxes). Ce champ est utilisé pour valider que le total de la facture ne change pas entre le moment où le client visualise la page finale listant tous ses achats et le moment où il procède à l'achat (le prix d'un produit pourrait avoir changé entre ces 2 moments si le marchand effectue une publication de nouveaux prix). Si la valeur calculée n'est pas égale à la valeur de ce champ un message d'erreur apparaîtra au client et celui-ci sera invité à repasser à la caisse. Ce champ est automatiquement ajouté au formulaire si vous utilisez les méthodes Checkout.Form.Begin et Checkout.Form.End.
• GrandTotal: ce champ représente le montant total (incluant tous les suppléments, rabais et taxes) de la facture du client. Ce champ est utilisé pour valider que le total de la facture ne change pas entre le moment où le client visualise la page finale listant tous ses achats et le moment où il procède à l'achat (le prix d'un produit pourrait avoir changé entre ces 2 moments si le marchand effectue une publication de nouveaux prix). Si la valeur calculée n'est pas égale à la valeur de ce champ un message d'erreur apparaîtra au client et celui-ci sera invité à repasser à la caisse. Ce champ est automatiquement ajouté au formulaire si vous utilisez les méthodes Checkout.Form.Begin et Checkout.Form.End.
• TotalAddOnKey: ce champ est utilisé pour valider que tous les suppléments que vous voulez ajouter à la facture sont bien légaux et qu'il n'en manque aucun. Ce champ doit absolument être présent. Vous ne pouvez cependant pas calculer sa valeur, et vous devrez absolument utiliser les méthodes Checkout.Form.Begin et Checkout.Form.End qui calculeront et afficheront cette valeur automatiquement, même si vous n'ajoutez aucun supplément.
• QuestionID: pour chacune des questions affichées, vous devrez avoir un champ QuestionID représentant un numéro unique à votre question (un numéro unique relatif à la commande, et non à toutes vos commandes). Ce champ doit apparaître autant de fois que vous avez de questions.
• QuestionName: pour chacune des questions affichées, vous devrez avoir un champ QuestionName représentant le nom de la question. Ce champ doit apparaître autant de fois que vous avez de questions.
• QuestionShortName: pour chacune des questions affichées, vous devrez avoir un champ QuestionShortName représentant le nom court de la question. Ce champ doit apparaître autant de fois que vous avez de questions.
• Answer_QuestionID: pour chacune des questions affichées, vous devrez avoir un champ Answer_QuestionID représentant la réponse à la question. Par exemple si vous avez un champ QuestionID=1, vous devrez avoir un champ Answer1. Ce champ doit apparaître autant de fois que vous avez de questions.
• QuestionItem_QuestionID: pour chacune des questions affichées, vous devrez avoir un champ QuestionItem_QuestionID représentant, s'il y a lieu, le produit auquel cette question se rapporte. Par exemple si vous avez un champ QuestionID=1, vous devrez avoir un champ QuestionItem1.
• CardNo: ce champ représente le numéro de carte de crédit du client. Ce champ est obligatoire si le paiement doit être par carte de crédit.
• CardName: ce champ représente le nom sur la carte de crédit du client. Ce champ est obligatoire si le paiement doit être par carte de crédit.
• CardExpMonth: ce champ représente le mois de la date d'expiration de la carte de crédit du client. Ce champ est obligatoire si le paiement doit être par carte de crédit.
• CardExpYear: ce champ représente l'année de la date d'expiration de la carte de crédit du client. Ce champ est obligatoire si le paiement doit être par carte de crédit.
• CardCVV: ce champ représente le code de vérification de la carte de crédit du client. Ce champ n'est pas obligatoire.
• Comments: ce champ représente les commentaires du client au marchand.
• CHK: ce champ représente une code de validation unique qui doit empêcher la transaction d'être enregistrée plus d'une fois. Ce champ est calculé automatiquement si vous utilisez les méthodes Checkout.Form.Begin et Checkout.Form.End
• SID: ce champ représente votre identificateur de marchand. C'est un numéro unique vous représentant. Utilisez Store.ID à cette fin.

Voici les méthodes et propriétés de la classe Checkout:

• AddOn (objet)
  • Add (méthode)
  • Cost (propriété)
  • Name (propriété)
  • Tax (objet)
    • Loop (objet)
      • Begin (méthode)
      • End (méthode)
    • Name (propriété)
    • Value (propriété)
  • Type (propriété)
  • Value (propriété)
• Billing (objet)
  • Address (propriété)
  • City (propriété)
  • Company (propriété)
  • Country (objet)
    • Code (propriété)
    • ID (propriété)
    • Name (propriété)
    • DivisionName (propriété)
  • Email (propriété)
  • Fax (propriété)
  • FirstName (propriété)
  • LastName (propriété)
  • Phone1 (propriété)
  • Phone2 (propriété)
  • State (objet)
    • Code (propriété)
    • ID (propriété)
    • Name (propriété)
  • ZIP (propriété)
• Country (objet)
  • ID (propriété)
  • Loop (objet)
    • Begin (méthode)
    • End (méthode)
  • Name (propriété)
  • NbElements (propriété)
• EPayment (objet)
  • Name (propriété)
  • Type (propriété)
• Error (objet)
  • Loop (objet)
    • Begin (méthode)
    • End (méthode)
  • NbElements (propriété)
  • Message (propriété)
• Form (objet)
  • Begin (propriété)
  • End (propriété)
• Items (objet)
  • AddToTotal (méthode)
  • Tax (objet)
    • Loop (objet)
      • Begin (méthode)
      • End (méthode)
    • Name (propriété)
    • Value (propriété)
• PasswordSent (propriété)
• Payment (objet)
  • ID (propriété)
  • Loop (objet)
    • Begin (méthode)
    • End (méthode)
  • Name (propriété)
  • Price (propriété)
  • PriceOverride (méthode)
  • Tax (objet)
    • Loop (objet)
      • Begin (méthode)
      • End (méthode)
    • Name (propriété)
    • Value (propriété)
  • Terms (propriété)
  • Type (propriété)
• Profile (objet)
  • Billing (objet)
    • Address (propriété)
    • City (propriété)
    • Company (propriété)
    • Country (objet)
      • Code (propriété)
      • ID (propriété)
      • Name (propriété)
    • Email (propriété)
    • Fax (propriété)
    • FirstName (propriété)
    • LastName (propriété)
    • Phone1 (propriété)
    • Phone2 (propriété)
    • State (objet)
      • Code (propriété)
      • ID (propriété)
      • Name (propriété)
    • ZIP (propriété)
  • Exists (propriété)
  • Shipping (objet)
    • Address (propriété)
    • City (propriété)
    • Company (propriété)
    • Country (objet)
      • Code (propriété)
      • ID (propriété)
      • Name (propriété)
    • Email (propriété)
    • Fax (propriété)
    • FirstName (propriété)
    • LastName (propriété)
    • Phone1 (propriété)
    • Phone2 (propriété)
    • State (objet)
      • Code (propriété)
      • ID (propriété)
      • Name (propriété)
    • ZIP (propriété)
• Question (objet)
  • Answer (objet)
    • Choice (propriété)
    • Loop (objet)
      • Begin (méthode)
      • End (méthode)
    • MaxLength (propriété)
    • Required (propriété)
    • Type (propriété)
  • Loop (objet)
    • Begin (méthode)
    • End (méthode)
  • Name (propriété)
  • ShortName (propriété)
  • Type (propriété)
• Redirect (méthode)
• Section (objet)
  • 1-99 (méthode)
  • End (méthode)
• Shipping (objet)
  • AM (propriété)
  • Address (propriété)
  • Carrier (objet)
    • ID (propriété)
    • Name (propriété)
  • City (propriété)
  • Company (propriété)
  • Country (objet)
    • Code (propriété)
    • ID (propriété)
    • Name (propriété)
    • DivisionName (propriété)
  • Date (propriété)
  • DeliveryDate (propriété)
  • Email (propriété)
  • Fax (propriété)
  • FirstName (propriété)
  • ID (propriété)
  • LastName (propriété)
  • Loop (objet)
    • Begin (méthode)
    • End (méthode)
  • Name (propriété)
  • Phone1 (propriété)
  • Phone2 (propriété)
  • Price (propriété)
  • PriceOverride (méthode)
  • State (objet)
    • Code (propriété)
    • ID (propriété)
    • Name (propriété)
  • Tax (objet)
    • Loop (objet)
      • Begin (méthode)
      • End (méthode)
    • Name (propriété)
    • Value (propriété)
  • ZIP (propriété)
• State (objet)
  • ID (propriété)
  • Loop (objet)
    • Begin (méthode)
    • End (méthode)
  • Name (propriété)
  • NbElements (propriété)
• Total (objet)
  • Tax (objet)
    • Loop (objet)
      • Begin (méthode)
      • End (méthode)
    • Name (propriété)
    • Value (propriété)