WebPay API - For your Web Application

Ce chapitre décrit en termes techniques les fonctionnalités de base du système de paiement standard ibous et son utilisation des formulaires. Utilisez les informations de ce chapitre pour vous guider dans l'intégration du code pour les boutons de paiement ibous.

Il existe 4 expériences de paiement ibous standard: Acheter maintenant, Faire un don, S'abonner ou Ibous Shopping Bouton pour effectuer des achats sur un site de commerce en ligne. Ce guide va vous décrire leur principales fonctionnalités et leur rôle respectif.

Les personnes qui vous paient via le système de paiement standard d'ibous interagissent avec les formulaires et les variables d'entrées masquées et cryptés que vous placez sur votre site Web. Lorsque quelqu'un clique sur un bouton de paiement dans un formulaire de paiement ibous sur une page Web, le formulaire soumet les variables et leurs valeurs à ibous. Vous définissez les valeurs des variables pour produire l'effet désiré, par exemple en invoquant l'expérience de paiement Acheter maintenant, Faire un don, S'abonner ou Ibous Shopping Cart et diverses autres fonctionnalités ibous.

Formulaire de paiement ibous
Attributs de formulaire - ACTION et METHOD

La balise FORM comprend deux attributs obligatoires, action et method, qui ressemblent toujours à ceci:


<FORM action="http://ibous.com/api/webpay" method="post">

Spécification du type de bouton - ib_cmd

La variable ib_cmd est toujours requise dans un FORM. Sa valeur détermine quelle expérience de paiement ibous standard vous utilisez pour obtenir un paiement.

Principaux Valeurs de la variable ib_cmd
Principaux Valeurs de la variable ib_cmd
  • Valeur de ib_cmd

    Description

  • _ib-buynow

    Bouton d'achat rapide pour article unique, bouton de paiement simple et facile a configuré.

  • _ib-shopping

    Bouton d'achat et de gestion de corbeille pour les achats sur les sites de commerce en ligne en récupérant la totalité des informations du panier.

  • _ib-auto-billing

    Bouton d'abonnement, bouton de facturation automatique.

  • _ib-donations

    Bouton Faire un don, permet de récupérer des dons.

Variables d'entrée cachées

Les variables d'entrée HTML dans un FORMULAIRE de paiement standard ibous sont toujours masquées dans la vue du payeur. Ils ont le format général suivant:


<INPUT TYPE="hidden" name="<NomDuVariable>" value="<ValeurAutorisée>">

La balise d'entrée ressemble à l'un des éléments suivants:

Acheter maintenant
<INPUT TYPE="hidden" name="ib_cmd" value="_ib-buynow">

ibous/ shopping bouton
<INPUT TYPE="hidden" name="ib_cmd" value="_ib-shopping">

S'abonner
<INPUT TYPE="hidden" name="ib_cmd" value="_ib-auto-billing">

Faire un don
<INPUT TYPE="hidden" name="ib_cmd" value="_ib-donations">

Important: ces balises INPUT sont requises exactement comme indiqué ci-dessus. Ne les change pas.

Présentation des variables

Valeur acceptée par la variable ib_cmd
Valeur Description
_ib-buynow Bouton d'achat rapide pour unique article, bouton de paiement simple et facile a configuré.
_ib-shopping Bouton d'achat et de gestion de corbeille pour les achats sur les sites de commerce en ligne en récupérant la totalité des informations du panier.
_ib-auto-billing Bouton d'abonnement, bouton de facturation automatique.
_ib-donations Bouton Faire un don, permet de récupérer des dons.

Variables de bases

Variables précédées de * sont obligatoires.
Nom Description
* ib_business Votre identifiant ibous ou une adresse e-mail associée à votre compte ibous. Les adresses e-mail doivent être confirmées.
* ib_currency_code Utiliser le variable ib_currency_code pour spécifier la devise du paiement.
* ib_cancel_return Variable contenant l'URL de votre site ou l'URL de la dernière page visitée par l'utilisateur pour pouvoir le rediriger s'il annule le paiement.
ib_return Variable contenant un URL pour pouvoir rediriger l'utilisateur en cas de succès du paiement.
* ib_amount Montant total.
* ib_item_name Variable contenant le nom de l'article. Disponible uniquement pour le bouton "Acheter maintentant".
* ib_quantity Variable contenant la quantité d'article. Disponible uniquement pour le bouton "Acheter maintentant".
* ib_item_name_cc Variable contenant tous les noms des articles du panier séparés par le délimiteur vertical |. Disponible uniquement pour le bouton "ibous Shopping".
* ib_quantity_cc Variable contenant le nombre respectif de la quantité des articles du panier séparés par le délimiteur vertical |. Disponible uniquement pour le bouton "ibous Shopping".
* ib_unite_price_cc Variable contenant le nombre respectif du montant unitaire des articles du panier séparés par le délimiteur vertical |. Disponible uniquement pour le bouton "ibous Shopping".
ib_shipping Variable contenant les taxes de livraison ou autres taxes supplémentaires.

Exemple de formulaire de Paiement ibous

                                      
          <form action="http://ibous.com/api/webpay" method="post">
            <input type="hidden" name="ib_cmd" value="_ib-shopping">
            <!-- _ib-shopping: ib_cmd value for shopping -->

            <input type="hidden" name="ib_business" value="jhonlouis@mail.com">
            <!-- email of merchant account-->

            <input type="hidden" name="ib_currency_code" value="HTG">
            <!-- Currency code-->

            <input type='hidden' name='ib_cancel_return' value='http://onlinestore.com'>
            <!-- URL to redirect if payment is cancelled-->

            <input name="ib_return" value="http://onlinestore.com/success" type="hidden">
            <!-- URL to redirect after successfull payment -->

            <input name="ib_item_name_cc" value="Bag|Multi-USB|Mini Laptop Bag" type="hidden">
            <input name="ib_quantity_cc" value="6|4|3" type="hidden">
            <input name="ib_unit_price_cc" value="80|45|89" type ="hidden">
            <!-- Shopping cart informations: All items details separated with delimiter | -->

            <input name ="ib_shipping" value ="4.78" type="hidden">
            <!-- Shopping additional information : tax for shipping-->

            <input type="hidden" name="ib_amount" value="218.78">
            <!--Amount total of Shopping cart-->

            <input type="submit" class="btn btn-success" value="Pay with ibous">
          </form>