# Ready integrations

The section contains applications with ready-made integrations, CRM, CMS, ERP plugins and instructions for them. Plugins for the CMS are hosted on the GitHub service; applications can be downloaded from the links provided in the sections. You can work with the plugin source code, which is located in the same repository where the archive files are located. If the plugin you need is not in the list, contact Support (opens new window), we will try to help.

PLEASE ATTENTION!

Plugins for CMS are implemented based on API requests. If you want to modify the plugin, check out the API reference.

# amoCRM

You can install the widget in two ways:

# 1.Installation via amoMarket

To do this, you need to open the “amoMarket” section, write “Mandarin” in the search bar and click the “Install for free” button in the widget block.

amoCRM_Mandarin

Next, check the box according to the screenshot and click the “Install” button.

amoCRM_Mandarin

Great! Now the widget is installed and you can go to its settings.

# 2.Install via link

To install the widget, open Link (opens new window) Select the amoCRM account into which you want to install the widget and click the “Allow” button

amoCRM_Mandarin

After clicking the button, the widget will automatically be installed in your account and will be available for configuration.

# Connecting and setting up stores

To connect a store, you need to open the “Settings” section in the widget and then open the “Stores” section

amoCRM_Mandarin

The widget has no restrictions on the number of connected stores.

To add a new store you need:

Enter any arbitrary value in “Store name”
Specify the “MID” parameter that you received from Mandarin technical support
Specify the “Secret Key” parameter that you received from Mandarin technical support

To complete the addition, click the “Add store” button.

Important!

To save the settings, click the “Save” button. Otherwise, after exiting the widget settings, no entered data will be saved.

Additionally, both when creating and editing store settings, you can:

Activate fiscalization To do this, you need to click on the checkbox to the right of the text “Enable fiscalization” and fill in the following data: 1.1 Tax system 1.2 VAT rate 1.3 Calculation method 1.4 Subject of calculation After filling in all the data as a result of payment, the acquiring company will generate checks and send them to the client, as well as to the Federal Tax Service (if you have set up an online cash register in the Mandarin account)
Activate a function of your choice (only one function from the proposed ones can be activated at a time): 2.1 Recurring default payments When you activate this checkbox in the window for generating payment links, the recurrence of payments will be automatically set, which you can also deactivate if necessary - this function is only responsible for the “default” setting. 2.2 Prepayment by default When you activate this checkbox in the window for generating payment links, the “Advance payment” criterion will be automatically set for the payment, which you can also deactivate if necessary - this function is only responsible for the “default” setting.

# Setting up field matching

To make the settings, you need to open the “Settings” section in the widget, then click on the “Transactions” button, and then click on the “Field Settings” button

amoCRM_Mandarin

The widget is a way to insert data such as:

Payment link The last generated link for payment within this transaction is inserted
Payment amount Total amount of payments made by the client
Prepayment amount The total amount of prepayments made by the client (when creating a payment link with the “Prepayment” parameter)
Number of recurring payments Total planned number of recurring payments
Amount of recurring payments Total planned amount of recurring payments

To set up field matching, you first need to create these fields in the deal card. If you have already made some settings in the widget, be sure to click the “Save” button so that the entered data is not lost.

Provided that the fields you need are available in the deal (if you have already created them, or they were there previously), select these fields in the list of available fields, which is displayed to the right of the corresponding parameter.

Important!

To save settingsYou must click the “Save” button. Otherwise, after exiting the widget settings, no entered data will be saved.

# Setting up automatic status change when paying

If payment is successful using the generated link, the widget is able to change the status of this transaction both in case of full payment and in case of prepayment.

To set up this function, you need to open the “Settings” section in the widget and then click on the “Deals” button, and then on the “Funnel setup” button

amoCRM_Mandarin

After opening this section, you can provide information such as:

Default store Select from the list of previously added stores the store that you want to be automatically selected in the link generation window in this funnel
Stage upon full payment Select from the list the stage to which you want transactions to move in case of full payment
Prepayment stage Select from the list the stage to which you want transactions to move in case of prepayment

Important!

To save the settings, click the “Save” button. Otherwise, after exiting the widget settings, no entered data will be saved.

# Generating a payment link

To generate a payment link, you need to open a transaction in amoCRM within which you want the link to be generated. Next, select the “Mandarin” section and then click on the “Create payment link” button

amoCRM_Mandarin

# Adding a product in the link generation window

Next, you need to add the product in the link generation window. To do this, click the “Add Product” button and select a product from the list of available ones This list displays products that you previously added to the “Products” list inside amoCRM

amoCRM_Mandarin

After adding a product, you will automatically have a price and quantity that you can edit.

# Setting up the generated link

When opening the “Store Settings” section, you can specify information such as:

Store This item displays a list of previously added stores, and also defaults to the store that you selected in the funnel settings
Activation of the recurring payments function When this checkbox is activated, the generated link will have a recurrence function and the client will be periodically debited in the amount that you specify in the “Number of payments” item.
Activate the prepayment function If you work with prepayments, then after activating this checkbox you will have the opportunity to specify the “Prepayment Amount”. In this case, the link will initially display the amount indicated as an advance payment and after making it within the same link, the client will be able to make the remaining payment.

After specifying all the data, click on the “Create link” button. If no errors occur, a link will be generated in accordance with the data you previously specified. As a result of creating the link:

The generated link will appear in the “Created Links” list
The last generated link will be automatically inserted into the transaction field that is specified in your settings

# Working with the generated payment link

The generated link will appear in the “Created Links” block. At any time you can open information by clicking on the block with the link you need

amoCRM_Mandarin

Within this block you will have the opportunity to copy the link in order to send it to the client

amoCRM_Mandarin

# Links with recurring payment

After making the first payment using the link, the client agrees to make all subsequent recurring payments. Write-offs will occur automatically. To cancel a recurring payment, you need to open a transaction within which this link was generated. After that, click on the block with a link with the “Recurring payment” attribute and then click on the “Cancel” button

amoCRM_Mandarin

# Automatic payment posting

After making the payment, the widget will automatically change the status of the transaction within which the link was generated to the status that you selected in the “Funnel Settings” section in the widget settings

It is also possible to move a transaction step by step if the “Prepayment” option is activated at the time the link is generated. In this case, the transaction will first change its status to the one specified in the settings as for the “Advance payment” status, and after making full payment, it will change to the status specified as for “Full payment”

When you open a transaction in the “Created Links” list, you will see the current payment status for the generated link.

amoCRM_Mandarin

# Bitrix24

Payment plugin (opens new window).
Installment plugin (opens new window). Each plugin specifies its own payment system, if two plugins are installed, the user will have a choice - Installment and Card payment.
Instructions (opens new window).

# Start

Install the plugin, links above.

Before you start setting up the Mandarin payment system module, you need to register your personal account on the platform (opens new window), instructions for creating a personal account can be found here (opens new window). After registering in the Mandarin account, open your project page and specify the value “https://mandarinio.bkvsoft.com/mandarin/app/Classes/UrlStarter.php?type=callback” without quotes as the “callback sending address” parameter.

Bitrix24_Mandarin

To configure the "Mandarin" payment system module, go to the "Sites and Stores" section by selecting the appropriate item from the left menu of the CRM portal. On the page that opens, select the "Payment systems" item from the drop-down list of the "Payments and Delivery" item in the top menu (Fig. 1). If the module has been successfully installed, the "Mandarin" payment system for the payer's physical type will appear in the list on the payment systems page. Select the payment system you need to configure and double-click on the name (or select “Edit” from the context menu) to change its parameters.

Bitrix24_Mandarin

# Setting up a payment system for card payments

On the "Payment system" tab, fill in the fields as follows (Fig. 2):

Handler: Mandarin Rest (MANDARIN)
Payment system type: leave blank by default
Heading: Payment by bank card
Title: Payment by bank card
Activity: set flag
Sorting: set as desired
Description:
Payment system logo: Loaded logo
Open in new window: leave as default
Payment type: Cashless
Allow automatic payment recalculation: leave as default
Allow receipt printing: leave as default
Encoding: leave as default
Code: leave as default
External code: MANDARIN

Bitrix24_Mandarin

# Setting up the PS handler

On the tabs of the "Setting up the PS handler" section, to configure all fields, you need to expand their display by clicking on the "Show all" link. To set up the Mandarin payment system, fill in the fields in the “Individual (s1)” tab. If any field on the tab ("Individual (s1)") has the "Default" flag set, then the value of this field will be taken from the corresponding field in the "Default" tab of the current payment system. Otherwise, the value that was specified directly in the field of this tab is taken into account (Fig. 3).

MID* (required) - Value (filled in from the MID field of your personal account on mandarinpay.com)
Secret* (required) - Value (filled in from the Secret-Key field of your personal account on mandarinpay.com)
Site domain* (required) - Value (indicate the site domain in the site.ru format without https://)
Payment type* (required) - One-stage or Two-stage optional
Transaction stage for debiting funds - The name of the stage, when transferring the transaction to which the frozen amount will be debited from the client’s account if the “Two-stage” payment type is selected. ATTENTION! The debit will be made for ALL active payments related to this transaction (created with a two-stage payment type).
Transaction stage for refund - Name of the stage, when transferring the transaction to which the frozen amount will be returned to the client’s account if the “Two-stage” payment type is selected. ATTENTION! A refund will be issued for ALL payments related to this transaction (created with a two-step payment type) that were not charged.

The fields in the "Payments" section should be left filled with default values.

Bitrix24_Mandarin

# Restrictions

On the "Restrictions" tab for the Mandarin payment system (Individual), the payer type "Individual" will be set automatically

# Setting up a payment system for installments

On the "Payment system" tab, fill in the fields as follows:

Handler: Mandarin Rest Credit (MANDARIN_CREDIT)
Payment system type: leave blank by default
Heading: Apply for a loan
Name: Apply for a loan
Activity: set the flag
Sorting: set as desired

Description:

Payment system logo: Uploaded logo
Open in a new window: leave by default
Payment type: Non-cash
Allow automatic recalculation of payment: leave by default
Allow printing of receipts: leave by default
Encoding: leave by default
Code: leave by default
External code: MANDARIN_CREDIT

Bitrix24_Mandarin

# Setting up a PS handler for installments

In the tabs of the "PS Handler Setup" section, to configure all fields, you need to expand their display by clicking on the "Show all" link. To configure the Mandarin payment system, fill in the fields of the "Individual (s1)" tab. If any field on the "Individual (s1)" tab has the "Default" flag set, the value of this field will be taken from the corresponding field of the "Default" tab of the current payment system. Otherwise, the value that was specified directly in the field of this tab is taken into account.

API key* (mandatory to fill) - Value (you need to request it from Support Service (opens new window))
Website domain* (mandatory to fill) - Value (the site domain is indicated in the format site.ru без https://)
The page the client will be redirected to after the loan is approved* (required) - indicates the link where the client will be redirected after the loan is successfully processed, must start with https://
The page to which the client will be redirected in case of refusal of credit* (mandatory) - the link to which the client will be redirected if the credit is refused is indicated, it must start with https://
The fields in the "Payments" section should be left filled in with the default values.

# Restrictions

On the "Restrictions" tab for the Mandarin payment system (Individual), the payer type "Individual" will be set automatically.

# GetCourse

How to set up installment plans and accept payments through Mandarin in GetCourse

Log in to your GetCourse account.
Select the “Site” → “Pages” section.
Select “System pages” → “Payment for order”.
Click the “Customize View” button.

# Adding styles

Select "Page" and paste the following code into the "Tags for the HEAD block" block:

<script type="text/javascript">
     // Settings for clients
     const CLIENT_SETTINGS = {
         apiKey: "*",
         merchantId: "*",
         token: "*",
         getCourseToken: "*",
         successReturnURL: "*",
         failReturnURL: "*",
         getCourseName: "*",
     };
</script>
<link rel="stylesheet" href="https://tools.mandarinpay.com/proxy/mandarin_getcourse.css" />

*Your data that needs to be inserted into the CLIENT_SETTINGS parameters and save the page:

Settings	Description
apiKey	The key for the installment widget can be obtained from the supervising Mandarin manager
merchantId	Your merchant ID can be obtained from the supervising Mandarin manager
token	Token for making payments. Receive via Support Service (opens new window) Mandarin
getCourseToken	Go to https://.getcourse.ru/saas/account/api, replacing with the name of your account on GetCourse, enter the name of the key in the “Create a new key” section, check the “For reading and writing” checkbox, click “ Generate secret key", copy and paste it here. Also, you need to pass getCourseToken to Support Service (opens new window) to configure callbacks
successReturnURL	The address where the buyer will return after payment, for example https://mycompany.com/payment/access
ailReturnURL	The address where the buyer will be redirected in case of unsuccessful payment, for example https://mycompany.com/payment/fail
getCourseName	account_name in GetCourse. Also, you need to pass getCourseName to Support Service (opens new window) to configure callbacks.

# Insert code for payment block

Select the location in the right panel where you want to embed the payment button and click "Add Block".
Select the HTML block from the list of elements.
Click on the added element and uncheck "Automatically correct typography" on the right in the "Basic" settings block.
Double-click on the added element to edit.

Please note!

You must insert the code in code entry mode. To do this, switch the editor by clicking on the <> symbol. You cannot edit an already added block; if you need to make changes, you must delete the block completely and insert it again.

GetCourse_system_pages

# Insert the following code if you are connecting an installment plan:

      <div class="mandarin-payments-container">
    <table>
      <tbody>
        <tr>
          <td style="text-align: left;">
            <img alt="Bank card" src="https://tools.mandarinpay.com/proxy/Mandarin_logo_main_red.svg" title="Bank card" width="200" height="100">
          </td>
          <td>
            <button id="mandarin_installmentPaymentBtn" class="btn btn-info mandarin-pay-button">Buy in installments</button>
          </td>
        </tr>
      </tbody>
    </table>
  </div>
  <div id="mandarin_installmentPopup" class="mandarin-popup">
    <div class="mandarin-popup-content" style="width: 350px;">
      <span class="mandarin-close-btn">×</span>
      <h2 style="margin-top: 10px;">Оплата в рассрочку</h2>
      <label style="margin-top: 40px;" for="mandarin_installmentPeriod">Select the installment period:</label>
      <div class="mandarin-select-wrapper">
        <select style="width: 250px;" id="mandarin_installmentPeriod">
          <option value="10">10 months</option>
          <option value="12">12 months</option>
          <option value="18">18 months</option>
          <option value="24">24 months</option>
          <option value="36">36 months</option>
        </select>
      </div>
      <button style="margin-top: 40px;" class="btn btn-info mandarin-pay-button" id="mandarin_confirmInstallment">Apply for an installment plan</button>
    </div>
  </div>
  <div id="emailPopup" class="mandarin-popup">
    <div id="email-popup" class="mandarin-popup-content">
        <span class="mandarin-close-btn">×</span>
        <h3>Email в GetCourse</h2>
        <input style="margin-top: 30px;" type="text" class="element-margin-top" id="popup-email-input" name="popup-email-input" required size="30" />
        <button style="margin-top: 30px;" id="mandarinSetButton" class="btn btn-info mandarin-pay-button">Pay</button>
    </div>
  </div>
  <div id="mandarin_spinnerWrapper" class="mandarin-popup">
    <div class="mandarin-popup-content">
      <div class="mandarin-spinner"></div>
    </div>
  </div>
  
  <script type="text/javascript">
    // Getting product data
    const mandarin_offerElement = document.querySelector(".deal-positions li[class^='offer-position-']");
    const mandarin_ProductId = mandarin_offerElement ? mandarin_offerElement.getAttribute("data-offer-id") : null;
    const mandarin_productNameElement = mandarin_offerElement ? mandarin_offerElement.querySelector(".position-actual-title") : null;
    const mandarin_ProductName = mandarin_productNameElement ? mandarin_productNameElement.innerText.trim() : null;
    
    // Getting the transaction id from the header
    const mandarin_titleText = document.title;
    const mandarin_orderIdMatch = mandarin_titleText.match(/#(\d+)/);
    const mandarin_orderId = mandarin_orderIdMatch ? mandarin_orderIdMatch[1] : null;
  
    // Getting order id from address bar
    const mandarin_orderNumber = window.location.href.split('/')[7].split('?')[0]; 
    
    // Getting a price
    const mandarin_price = parseInt($('p.deal-finish-price-title b').text().trim().replace(' ', ''));
    const mandarin_orderAmount = parseInt($('div.xdget-dealInfo p').first().text().replace(/[^0-9]/g, ''));
    let mandarin_fullOrPartPrice = (new URL(location.href)).searchParams.get('paymentValue');
    let mandarin_fullPriceIfPartPay = $('.page-full-block div div div div p').first().text().replace(/[^0-9]/g, '');
    const mandarin_isPartPayment = !!mandarin_fullOrPartPrice;
  
    
    // Getting user email
    let mandarin_inputElement = document.querySelector('input[name="params[DATA]"]');
    let mandarin_emailValue = mandarin_inputElement && mandarin_inputElement.value;
    let mandarin_userEmail = null;
    if (mandarin_emailValue && mandarin_emailValue.startsWith('Email=')) {
      mandarin_userEmail = mandarin_emailValue.split('Email=')[1];
    }
    
    if (window.currentUser && window.currentUser.email) {
      mandarin_userEmail = window.currentUser.email;
    }
    
    if(!mandarin_userEmail) {
      mandarin_userEmail = $('.xdget-currentUserInfo')?.html()?.split('\n')[2].split('\t')[0];
    }
  </script>
  <script src="https://tools.mandarinpay.com/proxy/mandarin_getcourse_v3.js"></script>

# If you need to add payment acceptance, you need to insert the following code:

<div class="mandarin-payments-container">
    <table>
      <tbody>
        <tr>
          <td style="text-align: left;">
            <img alt="Bank card" src="https://tools.mandarinpay.com/proxy/Mandarin_logo_main_red.svg" title="Bank card" width="200" height="100">
          </td>
          <td>
            <button id="mandarin_payOnlineBtn" class="btn btn-info mandarin-pay-button">Payment by card</button>
          </td>
        </tr>
      </tbody>
    </table>
  </div>
  <div class="mandarin-text-made-card">Payment by card issued by a bank in the Russian Federation</div>
  
  <div id="mandarin_spinnerWrapper" class="mandarin-popup">
    <div class="mandarin-popup-content">
      <div class="mandarin-spinner"></div>
    </div>
  </div>
  
  <script type="text/javascript">
    // Getting product data
    const mandarin_offerElement = document.querySelector(".deal-positions li[class^='offer-position-']");
    const mandarin_ProductId = mandarin_offerElement ? mandarin_offerElement.getAttribute("data-offer-id") : null;
    const mandarin_productNameElement = mandarin_offerElement ? mandarin_offerElement.querySelector(".position-actual-title") : null;
    const mandarin_ProductName = mandarin_productNameElement ? mandarin_productNameElement.innerText.trim() : null;
    
    // Getting the transaction id from the header
    const mandarin_titleText = document.title;
    const mandarin_orderIdMatch = mandarin_titleText.match(/#(\d+)/);
    const mandarin_orderId = mandarin_orderIdMatch ? mandarin_orderIdMatch[1] : null;
  
    // Getting order id from address bar
    const mandarin_orderNumber = window.location.href.split('/')[7].split('?')[0]; 
    
    // Getting a price
    const mandarin_price = parseInt($('p.deal-finish-price-title b').text().trim().replace(' ', ''));
    const mandarin_orderAmount = parseInt($('div.xdget-dealInfo p').first().text().replace(/[^0-9]/g, ''));
    let mandarin_fullOrPartPrice = (new URL(location.href)).searchParams.get('paymentValue');
    let mandarin_fullPriceIfPartPay = $('.page-full-block div div div div p').first().text().replace(/[^0-9]/g, '');
    const mandarin_isPartPayment = !!mandarin_fullOrPartPrice;
  
    
    // Getting user email
    let mandarin_inputElement = document.querySelector('input[name="params[DATA]"]');
    let mandarin_emailValue = mandarin_inputElement && mandarin_inputElement.value;
    let mandarin_userEmail = null;
    if (mandarin_emailValue && mandarin_emailValue.startsWith('Email=')) {
      mandarin_userEmail = mandarin_emailValue.split('Email=')[1];
    }
    
    if (window.currentUser && window.currentUser.email) {
      mandarin_userEmail = window.currentUser.email;
    }
    
    if(!mandarin_userEmail) {
      mandarin_userEmail = $('.xdget-currentUserInfo')?.html()?.split('\n')[2].split('\t')[0];
    }
  </script>
  <script src="https://tools.mandarinpay.com/proxy/mandarin_getcourse_v3.js"></script>

# If you need to use payment acceptance and installments at the same time, you must use the following code:

<div class="mandarin-payments-container">
  <table>
    <tbody>
      <tr>
        <td style="text-align: left;">
          <img alt="Bank card" src="https://tools.mandarinpay.com/proxy/Mandarin_logo_main_red.svg" title="Bank card" width="200" height="100">
        </td>
        <td>
          <button id="mandarin_payOnlineBtn" class="btn btn-info mandarin-pay-button">Payment by card</button>
        </td>
      </tr>
    </tbody>
  </table>
</div>
<div class="mandarin-text-made-card">Payment by card issued by a bank in the Russian Federation</div>

<div class="mandarin-payments-container">
  <table>
    <tbody>
      <tr>
        <td style="text-align: left;">
          <img alt="Bank card" src="https://tools.mandarinpay.com/proxy/Mandarin_logo_main_red.svg" title="Bank card" width="200" height="100">
        </td>
        <td>
          <button id="mandarin_installmentPaymentBtn" class="btn btn-info mandarin-pay-button">Buy in installments</button>
        </td>
      </tr>
    </tbody>
  </table>
</div>
<div id="mandarin_installmentPopup" class="mandarin-popup">
  <div class="mandarin-popup-content" style="width: 350px;">
    <span class="mandarin-close-btn">×</span>
    <h2 style="margin-top: 10px;">Оплата в рассрочку</h2>
    <label style="margin-top: 40px;" for="mandarin_installmentPeriod">Select the installment period:</label>
    <div class="mandarin-select-wrapper">
      <select style="width: 250px;" id="mandarin_installmentPeriod">
        <option value="10">10 months</option>
        <option value="12">12 months</option>
        <option value="18">18 months</option>
        <option value="24">24 months</option>
        <option value="36">36 months</option>
      </select>
    </div>
    <button style="margin-top: 40px;" class="btn btn-info mandarin-pay-button" id="mandarin_confirmInstallment">Apply for an installment plan</button>
  </div>
</div>
<div id="emailPopup" class="mandarin-popup">
  <div id="email-popup" class="mandarin-popup-content">
      <span class="mandarin-close-btn">×</span>
      <h3>Email в GetCourse</h2>
      <input style="margin-top: 30px;" type="text" class="element-margin-top" id="popup-email-input" name="popup-email-input" required size="30" />
      <button style="margin-top: 30px;" id="mandarinSetButton" class="btn btn-info mandarin-pay-button">Оплатить</button>
  </div>
</div>
<div id="mandarin_spinnerWrapper" class="mandarin-popup">
  <div class="mandarin-popup-content">
    <div class="mandarin-spinner"></div>
  </div>
</div>

<script type="text/javascript">
  // Getting product data
  const mandarin_offerElement = document.querySelector(".deal-positions li[class^='offer-position-']");
  const mandarin_ProductId = mandarin_offerElement ? mandarin_offerElement.getAttribute("data-offer-id") : null;
  const mandarin_productNameElement = mandarin_offerElement ? mandarin_offerElement.querySelector(".position-actual-title") : null;
  const mandarin_ProductName = mandarin_productNameElement ? mandarin_productNameElement.innerText.trim() : null;
  
  // Getting the transaction id from the header
  const mandarin_titleText = document.title;
  const mandarin_orderIdMatch = mandarin_titleText.match(/#(\d+)/);
  const mandarin_orderId = mandarin_orderIdMatch ? mandarin_orderIdMatch[1] : null;

  // Getting order id from address bar
  const mandarin_orderNumber = window.location.href.split('/')[7].split('?')[0]; 
  
  // Getting a price
  const mandarin_price = parseInt($('p.deal-finish-price-title b').text().trim().replace(' ', ''));
  const mandarin_orderAmount = parseInt($('div.xdget-dealInfo p').first().text().replace(/[^0-9]/g, ''));
  let mandarin_fullOrPartPrice = (new URL(location.href)).searchParams.get('paymentValue');
  let mandarin_fullPriceIfPartPay = $('.page-full-block div div div div p').first().text().replace(/[^0-9]/g, '');
  const mandarin_isPartPayment = !!mandarin_fullOrPartPrice;
  let isMandarinInstallment = false;
  
  // Getting user email
  let mandarin_inputElement = document.querySelector('input[name="params[DATA]"]');
  let mandarin_emailValue = mandarin_inputElement && mandarin_inputElement.value;
  let mandarin_userEmail = null;

  if (mandarin_emailValue && mandarin_emailValue.startsWith('Email=')) {
    mandarin_userEmail = mandarin_emailValue.split('Email=')[1];
  }
  
  if (window.currentUser && window.currentUser.email) {
    mandarin_userEmail = window.currentUser.email;
  }
  
  if(!mandarin_userEmail) {
    mandarin_userEmail = $('.xdget-currentUserInfo')?.html()?.split('\n')[2].split('\t')[0];
  }
</script>
<script src="https://tools.mandarinpay.com/proxy/mandarin_getcourse_v3.js"></script>

After that, click on the area outside the block and click on the "Save" button

Please note!

If for some reason the tags for receiving data on the payment page change, they can be adjusted in the code blocks "Receiving product data", "Receiving order ID from header", "Receiving price" or "Receiving user email". Also, if the payment/installment buttons do not respond to clicks, it is recommended to delete the block with the payment type and re-add it to the page.

# Plugin 1C

Plugin (opens new window)

# Instructions for loading the module

You need to load the extension into the client database; to do this, go to the “Administration” section - “Printed forms, reports and processing”.

1c_Mandarin

Then go to “Extensions”

1c_Mandarin

In the window that opens, click “Add from file” and specify the path to the file and click “Open”.

Important!

It is necessary for everyone to exit the database before loading the extension!

1c_Mandarin

Next there will be a window for applying the extension.

1c_Mandarin

After successful application of the extension, a message will appear indicating the need to restart the program into the database.

Important!

REMOVE THE "Safe Mode" FLAG!

1c_Mandarin

After successful addition and restart, Mandarin will appear.

1c_Mandarin

# Adding store settings in 1C

After successfully adding the extension, we configure the module. We go into the “Mandarin” subsystem - setup with the Mandarin server.

1c_Mandarin

Let's create a new project setting. Ideally, as many platforms as there are as many settings.

1c_Mandarin

If there are many sites, then for the convenience of the user you need to go to the warehouse and install the tincture in a specific warehouse. To do this, go to the “Directory” - “Warehouses” subsystem and go to the desired warehouse.

1c_Mandarin

Selecting a setting in the warehouse

1c_Mandarin

Then we try to pay from 1C to the card number of an individual. We go to the subsystem “Purchases” - “Receipts (acts, invoices, UPD).

1c_Mandarin

Let's create a new document.

Important!

The card payment button is only available in products!

1c_Mandarin

Fill in the required fields and click “Pay via Mandarin”.

1c_Mandarin

The Mandarin payment window will open.

Important!

To ensure that the fields are filled out as much as possible, check that all fields are filled in in the exchange settings, in the warehouse and in the counterparty itself!

1c_Mandarin

Information about successful and unsuccessful operations will be recorded in the operation log.

1c_Mandarin

It can be found in the section "Mandarin" - "Operation Log"

1c_Mandarin

# Downloading an extract from the MANDARIN system

If the extension is successfully added, the “Download from Mandarin” button will appear in the “Bank and Cash Office” - “Bank Statements” section

1c_Mandarin

When you click on it, the form opens:

1c_Mandarin

We indicate the organization, bank account and counterparty of the commission, as well as the path to the file downloaded from the Mandarin system and click “Fill in the table”.

1c_Mandarin

Click “Create Documents”, after which documents for debiting from the current account will be created, as well as a general commission document for these operations.

# Salebot

Detailed instructions on how to connect the Mandarin payment system to Salebot are available at link. (opens new window).

# 1cbit

# BIT.Debt management

In the CRM system for debt collection "BIT.Debt Management" from the company 1cbit, it is possible to connect functionality that allows you to increase the conversion of payments on debt obligations of individuals.

Submit a request for a demonstration of integration capabilities here (opens new window)

Integration of Mandarin and BIT.Debt Management allows you to:

Receive and record payment information online;
Connect auto payment to the debtor’s card with the highest conversion;
Send a direct link to pay the debt by email or SMS;
Set up automatic debits from the card according to the payment schedule.

The operator, in a conversation with the debtor, agrees on the amount that he is ready to repay. Then it sends a message, the link from which leads to the payment form. The payment made will be instantly reflected in the BIT.Debt Management software. Connecting automatic payment to the debtor’s card will significantly speed up collection and save the debtor from unnecessary costs for providing information via SMS, email and calls.

Integration from the application to the start of using the functionality takes 1-3 business days and depends on the speed of data provision.

# What needs to be configured before integration begins:

Mandarin combat account;
BIT.Debt management program.

To configure the system, contact a specialist in the implementation department or the supervising manager at First BIT.

Self-configuration is also possible, the detailed process is described in the instructions from the First BIT company at link (opens new window).

# Skillspace

# Registration of acquiring

If you do not yet have an acquiring system ready to work, leave a request for its connection (opens new window) in Mandarin.

The registration process is described at link (opens new window).

Information on commissions is individually agreed upon with each client, so please check this information with the supervising specialist. If you have an educational license, the commission will be lower.

# Integration setup

If your acquiring is already ready to work, all you have to do is connect it to Skillspace. To do this, log into your Skillspace account and go to School Settings - Payment Options, click Add another payment method.

Skillspace_Mandarin

In the window that appears, select the Mandarin payment method from the drop-down list.

Skillspace_Mandarin

Fill in the Terminal and Terminal Password fields.

Terminal is the numeric identifier for your project (store) in the Mandarin system. To find it, click Settings in the upper right corner as shown in the screenshot below. Copy this value and paste it into the Terminal field on Skillspace.

Skillspace_Mandarin

To find the Terminal Password you need to click Settings and click on the Project ID of the desired one. Next, you need to go to the Integration tab and click Go to API Secrets management, for more details, see the instructions Working with Secrets (opens new window), paste it into the Terminal Password field on Skillspace.

Next, you just need to fill in the fields Taxation system and VAT and click Add. Payment method has been added successfully.

Check that your terminal accepts payments in combat mode. To do this, click Settings → Project ID → General tab, the Sandbox slider should be turned off.

Skillspace_Mandarin

# Connecting Mandarin payment method to Skillspace courses

After successfully adding a payment method, you can connect it to any previously created course. To do this, go to the section Courses - Edit course - Course settings.

Skillspace_Mandarin

Scroll down the page to the Cost and payment block and in the Payment acceptance method field, select Mandarin from the drop-down list.

Skillspace_Mandarin

Ready! Now all payments from your students will go through the Mandarin payment system connected by you.

If you have any questions, ask them Mandarin technical support (opens new window) or email hello@skillspace.ru, we will be happy to help!

# Tilda

# Setting up a universal payment module

The article describes the process of setting up accepting payments through the Mandarin payment system for any website created using the Tilda Publishing website builder.

# Sequencing

In the admin panel of your website on Tilda, go to settings:

Tilda_Mandarin

In the left menu, select the "Payment systems" section:

Tilda_Mandarin

In the list of payment services, select "Universal payment system".

Tilda_Mandarin

In the list of universal payment system templates, find Mandarin.

Enter:

Login - enter MerchantID in the field - numeric identifier (opens new window) a combat project for accepting payments in the Mandarin system.
The secret for signing the order is secret key (opens new window) (Secret), required to authenticate requests.
URL for notifications - the Callback url to which Mandarin will send you a callback with information about operations.

Tilda_Mandarin

Fill in the remaining fields - currency, country, tax regime, payment widget language. If you need to generate checks, enter data for fiscalization (fields "ELECTRONIC CHECKS (RF)" and FDF).

In the SUCCESS PAGE URL field, enter the URL of the page to which the user will be redirected in case of successful payment.

In the REFUSE URL field, enter the URL of the page to which the user will be redirected if errors occur during the payment process. List of common error codes.

In the Title field, enter Mandarin.

Click "Save". On the "Payment systems" tab, Mandarin will appear in the list of connected ones:

Tilda_Mandarin

On pages with products, enable payment using Product sales scenario (opens new window) without selecting additional parameters or selling products with [selecting parameters](https: //help-ru.tilda.cc/online-store/parameters).

When you add payment blocks on any page of your site, the Mandarin payment system will be available:

Tilda_Mandarin

Important!

For the integration to work correctly, you need to add the Cart ST100 block in the order form settings; integration will not work with other blocks. You also need to configure how to fill out the email field.

# Diafan CMS

# Joomla

# CS-CART

Plugin (opens new window).

# Magento

Plugin (opens new window).

# PHP Shop

Plugin (opens new window).

# Prestashop

# Simpla

Plugin (opens new window).

# UMI.CMS

Plugin (opens new window).

# Webasyst

Plugin (opens new window).

# Wordpress

# Insales

You need to get the authorization data in the Mandarin system.

Next, in Insales you need to add a new payment method: "External payment method".

In the menu that appears, you must enter:

The value of MerchantID as the store ID.
The value of Secret as the password.
The value of http://pay.mandarinbank.com/mandarin_proxy.php as an external link.

The MerchantID and Secret parameters can be found in personal cabinet).

Then you have to go to personal account (opens new window) and write in the Callback url field the value of "URL to go to when the payment is successful" from Insales.

Detailed instructions are in the archive (opens new window).

# RadicalMart

RadicalMart is a solution for creating and operating an online store or selling landing page, taking into account different needs.

Payment plugin that integrates the Mandarin payment system into ecom projects managed by RadicalMart:

to the [plugin] page(https://sovmart.ru/catalog/plugins/radicalmart-payment-mandarin);
help with connection (opens new window).

Read more about the platform for creating online stores RadicalMart on the official website (opens new window).

← Bulk payouts Basic principles →

# Ready integrations

# amoCRM

# Installing a widget in amoCRM

# 1.Installation via amoMarket

# 2.Install via link

# Initial widget setup

# Connecting and setting up stores

# Setting up field matching

# Setting up automatic status change when paying

# Using the widget

# Generating a payment link

# Adding a product in the link generation window

# Setting up the generated link

# Working with the generated payment link

# Links with recurring payment

# Automatic payment posting

# Bitrix24

# Start

# Setting up a payment system for card payments

# Setting up the PS handler

# Restrictions

# Setting up a payment system for installments

# Setting up a PS handler for installments

# Restrictions

# GetCourse

# GetCourse Login

# Adding styles

# Insert code for payment block

# Insert the following code if you are connecting an installment plan:

# If you need to add payment acceptance, you need to insert the following code:

# If you need to use payment acceptance and installments at the same time, you must use the following code:

# Plugin 1C

# Instructions for loading the module

# Adding store settings in 1C

# Downloading an extract from the MANDARIN system

# Salebot

# 1cbit

# BIT.Debt management

# What needs to be configured before integration begins:

# Skillspace

# Registration of acquiring

# Integration setup

# Connecting Mandarin payment method to Skillspace courses

# Tilda

# Setting up a universal payment module

# Sequencing

# Diafan CMS

# Joomla

# CS-CART

# Magento

# PHP Shop

# Prestashop

# Simpla

# UMI.CMS

# Webasyst

# Wordpress

# Insales

# RadicalMart