Bitrix Site Manager

Handling payment systems

In this section

  • Handler file example
  • The processing results
  • Predefined templates
  • The integration of an e-store with payment systems is implemented by the payment system processing files. These files are created individually for each payment system and called after order completion and also when the customer chooses the order repeat function in the personal section. This file can contain a script which will display the required payment paper, or the form for sending data to the payment system.

    The following are the steps required to integrate handler files:

    Handler file example

    A typical Handler file looks as follows (for http://www.secpay.com).

    <form name="secpay" action="https://www.secpay.com/java-bin/ValCard" method=POST>
    
    <!-- You code in the system -->
    Merchant Id
    <input type="hidden" name="merchant" value="secpay">
    
    <!-- Unique transaction number -->
    Transaction Id
    <input type="hidden" name="trans_id" value="Invoice_<?echo $ORDER_ID ?>">
    
    <!-- Sum -->
    The Amount
    <input type="hidden" name="amount" value="<?echo $arOrder["PRICE"]?>">
    
    <!-- Transition addresses according to the successful and unsuccessful payment -->
    The Callback
    <input type="hidden" name="callback" 
    value="http://www.mysite.com/successcallback.html;http://www.mysite.com/failcallback.html">
    
    <!-- Test request indication -->
    <input type=hidden name="options" value="test_status=true,dups=false">
    
    <!-- Additional parameters -->
    <input type=hidden name="font_face" value="Arial">
    <input type=hidden name="bgcolor" value="white">
    <input type="submit" value="Submit Order">
    
    </form>

    You need to specify the syntax (communication interface) of the payment system in the technical support service of this payment system.

    The processing results

    The ability to automatically receive the result and order payment parameters from a payment system depends on the specific payment system. You can use the two basic methods to receive response from a payment system.

    Predefined templates

    These templates are located in /bitrix/modules/sale/payment/. Copy the required templates to /bitrix/php_interface/include/payment before editing them.

    File Description
    assist.php Handler file for credit card payments using the assist.ru system.
    assist_rapida.php Handler file for credit cards payments using the Rapida system via assist.ru.
    assist_res.php Result acquisition script for use with the assist.ru system.
    betaling.php Handler file for credit card payments via http://betaling.viborgnet.dk.
    bill.php Handler file for the bank transfers (bill print-out).
    bill_body.php Help file for use with bill.php.
    ibill.php Handler file for credit card payments by using the ibill.com system.
    ibill_f.php Handler file for credit card payments via ibill.com with the result acquisition.
    paycash.php Handler file for payments by using the Yandex.Money system.
    paypal.php Handler file for credit card payments via paypal.com.
    post.php Handler file for the postal orders payment.
    sberbank.php Handler file for payments via the Savings Bank of Russia.
    webmoney.php Handler file for payments via Webmoney.