To add PayPal Checkout, you need to configure the settings on the payment gateway side and add the module in BILLmanager. The main difference from the "PayPal" payment method is that this gateway allows for refunds. 

Payment methods support
Bank cardsCashE-walletsMobile paymentsOnline banking

American Express,

PayPal Wallet.

Supported features
Payments return

Recurring payments


Configuring the payment method

To integrate the payment gateway with BILLmanager add a new application in PayPal PayPal client area → Dashboard → REST API apps Create App. To set up the integration on the billing platform side, you will need the Client_ID and Secret fields. 

Configuring BILLmanager

The module is installed from the latest available version of the product and requires an update of the BILLmanager platform, because the module version cannot be higher than the platform version.

To create a payment module, enter Provider Payment methods → click Add. The payment module adding wizard consists of the following steps:

  1. Select a payment methods: "PayPal Checkout".
  2. Integration settings. Specify the data for integration:
    Activate the Add New Client option to display a link to register with the handler's system.
    Complete the form using the details of an existing client in the handler's system:
    1. Application ID — unique identifier. To find the id, log  into your PayPal client area → Dashboard → REST API apps Client_ID
    2. Secret key — application key to access API PayPal. To find the id, log  into your PayPal client area → Dashboard → REST API apps Secret
    3. Test mode — select the check box to activate a test mode for this payment method.  You need to register a new account at
    4. Logo URL — URL of the provider's logo. Clients will see the logo on the payment page. The recommended size is 190х60 pcs.  We recommend that you start the URL with "https://" so that browsers won't mark the BILLmanager page unsafe. 
  3. Payment method settings. Configure internal (within BILLmanager) parameters of the service payment module. For more details, see How to add a payment gateway module.

Additional information 


The following is a list of supported currencies 

IdNameInternational nameNotes
AUDAustralian dollarAustralian dollar
BRLBrazilian realBrazilian realThis currency is supported for in-country PayPal accounts only
CADCanadian dollarCanadian dollar
CZKCzech korunaCzech koruna
DKKDanish kroneDanish krone
HKDHong Kong dollarHong Kong dollar
INRIndian rupeeIndian rupeeThis currency is supported for in-country PayPal accounts only
ILSИзраильский шекельIsraeli new shekel
MYRMalaysian dollarMalaysian ringgitThis currency is supported for in-country PayPal accounts only
MXNMexican pesoMexican peso
NZDNew Zealand dollarNew Zealand dollar
NOKNorwegian kroneNorwegian krone
PHPPhilippine pesoPhilippine peso
PLNPolish zlotyPolish złoty
GBPPound sterlingPound sterling
RUBRussian rubleRussian ruble
SGDSingapore dollarSingapore dollar
SEKSwedish kronaSwedish krona
CHFSwiss francSwiss franc
THBThai bahtThai baht
USDUS dollarUnited States dollar

By default some currencies are not supported for the account. To accept payments in an unsupported currencies, log in to your PayPal account → Profile and settingsMy selling tools → Payment receiving preferences → Payments sent to you in a currency you don't hold. Clear the check box if you want to manually approve the payments sent to you in a currency you don't hold.


A commission is charged for every finance operation that the service provider performs. 

Turnover, rubles per monthCommission for operation 
up to 300 0003,9 % + 10,00 rub.
300 000 – 750 0003,7 % + 10,00 rub.
750 000 – 1 500 0003,4 % + 10,00 rub.


To enable refunds, navigate to Provider Payment methods → Edit→ Allow refunds. You can refund only "Paid" payments.


PayPal Checkout has the following log files:

  • /usr/local/mgr5/var/pmpaypalco.log — configuration details of the payment method.;
  • /usr/local/mgr5/var/ppcopayment.log — payment log;
  • /usr/local/mgr5/var/ppcoresult.log — responses from the payment gateway.

Possible issues with partial refunds

Partial refund may not be supported in the test mode. The log file contain the following information:

"name":"TRANSACTION_REFUSED","message":"Request was refused.You can not do a partial refund on this transaction","information_link":"","debug_id":"d4ac41412c103"

To resolve the issue, disable the payment verification option your PayPal client area: 

  1. Log into PayPal developer account.
  2. Navigate to Sandbox accounts Profile.
  3. In Settings disable the option Payment Review.