{"id":3282,"date":"2023-04-14T09:52:53","date_gmt":"2023-04-14T07:52:53","guid":{"rendered":"https:\/\/help.ino.cx\/?post_type=ht_kb&p=3282"},"modified":"2026-07-09T17:07:22","modified_gmt":"2026-07-09T15:07:22","slug":"payment-modules","status":"publish","type":"ht_kb","link":"https:\/\/help.ino.cx\/index.php\/help-center\/payment-modules\/","title":{"rendered":"Payment modules – Set them up"},"content":{"rendered":"\n
\"Smart<\/figure>\n\n\n\n

[Reading time: 8 minutes<\/em>]<\/p>\n\n\n\n

Overview<\/h2>\n\n\n\n

A Payment module<\/strong> is the configuration object that lets your platform collect payments from customers \u2014 through the advisor\u2019s Banner, through an IVR, through an SMS or email link, or through a web widget integrated on your website. Each payment module is connected to a banking contract (which determines who actually processes the transactions: Ino pay or Stripe) and defines:<\/p>\n\n\n\n

    \n
  • Which channels<\/strong> customers can use to pay.<\/li>\n\n\n\n
  • Which payment terms<\/strong> are offered (instantaneous, scheduled or in installments).<\/li>\n\n\n\n
  • The confirmations<\/strong> sent after the payment.<\/li>\n\n\n\n
  • The appearance<\/strong> of the web payment form, when used.<\/li>\n<\/ul>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    You can configure several payment modules in parallel \u2014 typically one per business activity, brand or currency \u2014 and associate them with different advisor profiles.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    1. Prerequisites and permissions<\/h2>\n\n\n\n

    Payment modules are configured in the Maker<\/strong>, in the Payment<\/strong> module. From the left menu, open Payment > Payment modules<\/strong>. The module is part of the Smart licence.<\/p>\n\n\n\n

    Before creating a payment module:<\/p>\n\n\n\n

      \n
    • At least one banking contract<\/strong> must already exist in Payment > Banking contracts<\/strong>. The banking contract is what connects the platform to the actual payment processor \u2014 Ino pay<\/strong> (France only) or Stripe<\/strong>.<\/li>\n\n\n\n
    • If you plan to use the SMS or Email channel, the corresponding sender (SMS number, mailbox) and the request templates must be configured beforehand.<\/li>\n<\/ul>\n\n\n\n

      Two layers of permissions apply:<\/p>\n\n\n\n

        \n
      • Role<\/strong> (configuration): the right Payment modules<\/em> (Read \/ Create \/ Modify \/ Delete) is needed to manage the modules from the Maker.<\/li>\n\n\n\n
      • Profile<\/strong> (usage): an advisor profile is associated with one or more payment modules to use them at runtime. The profile also carries the operational rights Can make banner payments by bank card<\/em>, Can make banner payments by Smart Routing<\/em>, Can make link payments (sent by SMS or Email)<\/em> and Can cancel an invoice<\/em>.<\/li>\n<\/ul>\n\n\n\n

        2. General settings<\/h2>\n\n\n\n

        To create a new payment module, go to Maker > Payment > Payment modules<\/strong> and click the +<\/strong> button. The form is divided into several sections, starting with Payment module general settings<\/em>:<\/p>\n\n\n\n

        Field<\/th>Required<\/th>Description<\/th><\/tr><\/thead>
        Name<\/strong><\/td>Yes<\/td>Display name of the module.<\/td><\/tr>
        Alias<\/strong><\/td>No<\/td>Short label for filtering and search.<\/td><\/tr>
        Description<\/strong><\/td>No<\/td>Free text description.<\/td><\/tr>
        Banking contract<\/strong><\/td>Yes<\/td>The contract used to process payments. The contract type (Ino pay \/ Stripe) determines which channels and options are available below.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        \"\"<\/figure>\n\n\n\n

        2.1. Security (Ino pay contracts only)<\/h3>\n\n\n\n

        For Ino pay contracts, you can cap the amount of a single transaction:<\/p>\n\n\n\n

          \n
        • Limit amount for a transaction<\/strong>: toggle that enables the limit.<\/li>\n\n\n\n
        • Maximum amount<\/strong>: the cap, in euros (between 1 \u20ac and 1,000,000 \u20ac).<\/li>\n<\/ul>\n\n\n\n

          2.2. Endpoint<\/h3>\n\n\n\n

          Two optional endpoint settings are used by the SMS, Email and reminder\/confirmation features:<\/p>\n\n\n\n

            \n
          • SMS sender<\/strong>: the SMS number from which payment requests and confirmations are sent.<\/li>\n\n\n\n
          • Mailbox<\/strong>: the mailbox from which payment emails are sent.<\/li>\n<\/ul>\n\n\n\n
            \"\"<\/figure>\n\n\n\n

            3. Appearance<\/h2>\n\n\n\n

            The Appearance<\/strong> section customises the look of the web payment template that is presented to the customer when they pay through the Web channel. The settings here are also used as defaults by the SMS and Email channels when they direct the customer to the web payment page.<\/p>\n\n\n\n

              \n
            • One or several Title<\/strong> entries, one per language (for example a French title, an English title, a Spanish title).<\/li>\n\n\n\n
            • A Color<\/strong> picker.<\/li>\n\n\n\n
            • A custom Favicon<\/strong> and a custom Logo<\/strong> \u2014 uploaded as images. Both can be reset to the platform default.<\/li>\n<\/ul>\n\n\n\n

              4. Payment form \u2014 additional fields<\/h2>\n\n\n\n

              The Payment form<\/strong> section lets you add two optional fields that the advisor (or the customer on the Web channel) fills in when starting a payment, in addition to the always-required amount, phone number and email address:<\/p>\n\n\n\n

              Field<\/th>Description<\/th><\/tr><\/thead>
              Invoice ID<\/strong><\/td>An identifier of the invoice being paid. The format can be Text, String, Number or a Regex pattern. The field can be made required.<\/td><\/tr>
              Customer number<\/strong><\/td>An identifier of the customer. Same format choices and same required toggle as the Invoice ID.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

              Leaving both fields off keeps the payment form minimal \u2014 only the amount, phone number and email are asked.<\/p>\n\n\n\n

              5. Confirmations<\/h2>\n\n\n\n

              The Confirmations<\/strong> section configures the messages sent to the customer once a payment has been successfully made.<\/p>\n\n\n\n

                \n
              • Email<\/strong>: pick a Payment confirmation template<\/em> to send a confirmation email.<\/li>\n\n\n\n
              • SMS<\/strong>: pick a Payment confirmation template<\/em> to send a confirmation SMS.<\/li>\n<\/ul>\n\n\n\n

                You can enable either or both. Confirmations are sent from the SMS sender and mailbox configured in the Endpoint section.<\/p>\n\n\n\n

                6. Payment channels<\/h2>\n\n\n\n

                The Payment channel<\/strong> section lets you enable up to five channels through which the customer can pay. Each channel has its own toggle and its own specific settings.<\/p>\n\n\n\n

                Channel<\/th>Specific settings<\/th><\/tr><\/thead>
                BANNER<\/strong> \u2013 Enable the banner channel<\/em><\/td>Allows the advisor to take a payment directly from the Banner during an interaction. The Blur credit card information<\/strong> option blurs the card number on the advisor\u2019s screen during input. Not available on Stripe contracts.<\/td><\/tr>
                IVR<\/strong> \u2013 Enable the IVR channel<\/em><\/td>Allows the customer to enter their card number, expiry date and CVV directly on the phone keypad during a call. Requires three sound files: Sound file that requests entering the card number<\/em>, The sound file that requests entering the card expiry date<\/em>, Sound file that requests entering the card CVV<\/em>. Not available on Stripe contracts.<\/td><\/tr>
                SMS<\/strong> \u2013 Enable the SMS channel<\/em><\/td>The customer receives a payment link by SMS, sent from the SMS sender configured in the Endpoint section. Requires a Payment request template<\/strong>.<\/td><\/tr>
                Email<\/strong> \u2013 Enable the email channel<\/em><\/td>The customer receives a payment link by email, sent from the mailbox configured in the Endpoint section. Requires a Payment request template<\/strong>.<\/td><\/tr>
                Web<\/strong><\/td>Embeds the payment form on your own website using the integration code (see section 6.1). A Return URL<\/strong> can be configured to redirect the customer after payment, whether successful or not. Not available on Stripe contracts. <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                At least one of the Banner, IVR, SMS or Email channels must be enabled for the module to be usable.<\/p>\n\n\n\n

                6.1. Web channel \u2014 Integration guide<\/h3>\n\n\n\n

                When the Web channel is enabled, an Integration guide<\/strong> button opens a panel with the HTML\/JavaScript snippet to paste in your website. The snippet has two kinds of replacements:<\/p>\n\n\n\n

                  \n
                • Required values<\/strong>:\n
                    \n
                  • HTML container ID<\/strong>: the ID of the HTML element in which the payment form is inserted on your page.<\/li>\n\n\n\n
                  • Variable containing the invoice ID<\/strong>: a dynamic value pointing to the invoice ID of the current customer.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                  • Optional values<\/strong>: title (FR \/ EN \/ ES), customised color, URLs of your favicon and logo. If left blank, the values set in the Appearance section are used.<\/li>\n<\/ul>\n\n\n\n

                    Three optional callbacks<\/strong> can be wired to the embed code: onCancelCb()<\/code> (Cancel button clicked), onSuccessCb()<\/code> (payment button clicked) and onErrorCb(errorCode)<\/code> (payment error). A Copy the code to the clipboard<\/strong> button lets you copy the snippet in one click.<\/p>\n\n\n\n

                    7. Payment terms (Ino pay only)<\/h2>\n\n\n\n

                    The Payment terms<\/strong> section defines how the customer can spread the payment. Three terms can be enabled independently (at least one must be enabled).<\/p>\n\n\n\n

                    7.1. Instantaneous<\/h3>\n\n\n\n

                    Activated with Enable instantaneous payment<\/strong>. The customer pays the full amount immediately, in a single transaction. No additional setting.<\/p>\n\n\n\n

                    7.2. Scheduled<\/h3>\n\n\n\n

                    Activated with Enable scheduled payment<\/strong>. The customer chooses a date in the future for the payment. One setting:<\/p>\n\n\n\n

                      \n
                    • Maximum number of days before payment<\/strong>: how far in the future the payment can be scheduled (between 1 and 120 days).<\/li>\n<\/ul>\n\n\n\n

                      7.3. In installments<\/h3>\n\n\n\n

                      Activated with Enable payment in installments<\/strong>. The amount is split into several deadlines.<\/p>\n\n\n\n

                      Field<\/th>Description<\/th><\/tr><\/thead>
                      1st installment within maximum<\/strong><\/td>Number of days within which the first installment must take place (between 0 and 30 days).<\/td><\/tr>
                      Possibility of spreading the costs<\/strong><\/td>If enabled, the additional costs are spread across the installments. Otherwise, all costs are charged with the first payment.<\/td><\/tr>
                      Installment dates<\/strong><\/td>Free<\/em>: the advisor can change the dates within the limits of the frequency. Automatic<\/em>: dates are calculated from the date of the 1st payment and cannot be modified.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                      7.4. Offer(s) \u2014 for installments<\/h3>\n\n\n\n

                      When In installments<\/em> is enabled, one or several offers<\/strong> describe the splitting options available to the customer. Each offer is a row in the offers table with:<\/p>\n\n\n\n

                        \n
                      • Due date<\/strong>: the number of installments (and time<\/em> unit).<\/li>\n\n\n\n
                      • Periodicity<\/strong>: weekly, monthly, quarterly, biannual or annual.<\/li>\n\n\n\n
                      • Costs<\/strong>: the extra cost for choosing this offer.<\/li>\n\n\n\n
                      • Cost type<\/strong>: a fixed amount in euros or a percentage.<\/li>\n<\/ul>\n\n\n\n

                        At least one offer is required when In installments<\/em> is enabled.<\/p>\n\n\n\n

                        \"\"<\/figure>\n\n\n\n

                        8. Testing cards<\/h2>\n\n\n\n

                        While the payment module is in sandbox mode, a Testing cards<\/strong> section lists card numbers you can use to simulate different payment results. Each card returns a specific outcome:<\/p>\n\n\n\n

                        Status<\/th>Outcome<\/th><\/tr><\/thead>
                        Successful<\/strong><\/td>The transaction succeeds.<\/td><\/tr>
                        Card issuer unknown<\/strong><\/td>The issuer is not recognised.<\/td><\/tr>
                        Suspicion of fraud<\/strong><\/td>The transaction is rejected for fraud suspicion.<\/td><\/tr>
                        Payment failed<\/strong><\/td>A generic payment failure.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                        Use these cards to validate your channel and template configuration before switching the module to production.<\/p>\n\n\n\n

                        9. Edit, delete and activation<\/h2>\n\n\n\n

                        From the Payment modules<\/strong> list, each row provides an Edit<\/strong> action and a Delete<\/strong> action. Several modules can be deleted at once by selecting them in the list and using the bulk delete action.<\/p>\n\n\n\n

                        A payment module can be in one of three states: Off<\/strong>, Sandbox<\/strong> or On<\/strong>. Once a module is activated (state On<\/em>), most of its settings become read-only and the form displays the message \u201cYou can not modify this module because it is activated.\u201d<\/em> To edit an activated module, switch it back to Sandbox or Off first.<\/p>\n","protected":false},"excerpt":{"rendered":"

                        The payment modules allow you to set up transactions before, after and during your interactions with your customers. Depending on the banking contract type and your country, payment can also be spread over several months, with SMS and\/or email reminders.
                        \nToday, we will see how to create a payment module and then use it.<\/p>\n","protected":false},"author":3,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[107],"ht-kb-tag":[147,131,162],"class_list":["post-3282","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-configuring","ht_kb_tag-admin","ht_kb_tag-maker","ht_kb_tag-payment"],"_links":{"self":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/3282","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/comments?post=3282"}],"version-history":[{"count":10,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/3282\/revisions"}],"predecessor-version":[{"id":6671,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb\/3282\/revisions\/6671"}],"wp:attachment":[{"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/media?parent=3282"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=3282"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.ino.cx\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=3282"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}