Skip to main content

Payouts to the Russian Federal Tax Service

Google tax—is a value-added tax (VAT) for foreign companies that provide electronic services to customers in Russia. To pay it using our API, contact your manager.

Possible scenarios​

With an automatic deduction. This scenario is for you if you accept payments through Bank 131. Bank 131 automatically withholds the tax amount from each payment. When the payment deadline arrives, the funds are already in your collateral account.

With account top-up. You top up your collateral account with Bank 131. Then, the Bank executes your orders for payouts to the tax service.

To check the collateral account balance, use the wallet/balance method.

How to pay the tax​

To pay the tax, specify the following bank details:

BIC: 017003983 
Treasury Account: 03100643000000018500 
Treasury Single Account: 40102810445370000059 
Recipient: Federal Treasury of Russia (Federal Tax Service of Russia)
INN: 7727406020 
KPP: 770801001
KBK: 18201061201010000510

Send a session/init/payout request with a minimal or extended set of parameters, when you need to specify additional details (for example, KBK, OKTMO, period, etc.).

Payout with a minimal set of parameters​

Request parameters

NameMandatoryTypeDescription
payment_method/payout_details+arrayPayout data
  type+stringValue: tax
  tax+objectData for making a VAT payout
    type+stringPayout method. Always: tax_short
    tax_details+objectTax details
amount_details+objectAmount
  amount+intAmount in ruble decimal format. The value must be greater than zero. To send 100 rubles, specify 10000
  currency+stringISO 4217 currency code. Case insensitive. Always: rub
Request example 
curl -X POST \
  https://demo.bank131.ru/api/v1/session/init/payout \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "amount_details": {
      "amount": 20000,
      "currency": "rub"
    },
    "payment_method": {
      "type": "tax",
      "tax": {
        "type": "tax_short",
        "tax_details": {}
      }
    }
  }'

Payout with an extended set of parameters​

Request parameters

NameMandatoryTypeDescription
payment_method/payout_details+arrayPayout data
  type+stringValue: tax
  tax+objectData for making a VAT payout
    type+stringPayout method. Always: tax_full
    uin+stringUIN. Always: 0
    description+stringPayout purpose
    tax_details+objectTax details
      period+stringTax period
      kbk+stringBudget Classification Code, 20 digits
      oktmo+stringAll-Russian Classifier of Territories of Municipal Formations, 8 or 11 digits
      payment_reason+stringPayment reason
      document_number+stringDocument number
      document_date+stringDocument date
    payer+objectTaxpayer's data
    payee+objectRecipient's data
amount_details+objectAmount
  amount+intAmount in ruble decimal format. The value must be greater than zero. To send 100 rubles, specify 10000
  currency+stringISO 4217 currency code. Case insensitive. Always: rub

Parameter values​

payment_reason​
  • TP – for current-period tax/contribution payment
  • ZD – for voluntary repayment of tax/contribution arrears
  • TR – for debt repayment based on a demand issued by the tax authority or the Social Security Fund (FSS)
  • AP – for debt repayment based on audit findings (before a demand is issued)
period​
  • If the payment_reason parameter contains TP or ZD, the tax payment frequency established by legislation is indicated in one of the formats below:
    • for monthly payments: MS.MM.YYYY, where MM is the month (from 01 to 12), and YYYY is the year for which the payment is made (for example, when paying personal income tax for employees' salaries for February 2026, use MS.02.2025)
    • ror taxes paid quarterly: KV.QQ.YYYY, where QQ is the quarter (from 01 to 04), and YYYY is the year for which the tax is paid
    • for semi-annual taxes (e.g., UTII): PL.HH.YYYY, where HH is the half-year (01 or 02), and YYYY is the year for which the tax is remitted
    • for annual payments: GD.00.YYYY, where YYYY is the year for which the tax is paid (for example, when making the final calculation for corporate profit tax for 2025, use GD.00.2025)
  • If the payment_reason parameter contains TR, specify the demand date
  • If the payment_reason parameter contains AP, specify 0
document_number​

If the payment_reason parameter contains:

  • TP or ZD, specify 0
  • TR, specify the tax demand number
  • AP, specify the audit decision number
Input format for the document_date field​

If the payment_reason parameter contains:

  • TP, specify the declaration signing date or 0 if the date is missing
  • ZD, specify 0
  • TR, specify the tax demand date
  • AP, specify the post-audit decision date
Request example 
curl -X POST \
  https://demo.bank131.ru/api/v1/session/init/payout \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "payment_method": {
      "type": "tax",
      "tax": {
        "type": "tax_full",
        "tax_details": {
          "period": "КВ.04.2025",
          "document_number": "12345",
          "kbk": "18210301000011000110",
            "oktmo": "45348000",
            "payment_reason": "ЗД",
            "document_date": "01-07-2025"
        },
        "description": "test payment",
        "uin": "0",
        "payer": {
          "inn": "1234567890",
          "kpp": "044525416"
        },
        "payee": {
          "bik": "017003983",
          "account": "30102810400000000001",
          "account_eks": "40101810045250010041",
          "name": "name",
          "kpp": "770701001",
          "inn": "7707500730"
        }
      }
    },
    "amount_details": {
      "amount": 5900,
      "currency": "rub"
    },
    "customer": {
      "reference": "lucky",
      "contacts": [{
        "email": "user123@test.com"
      }]
    },
    "metadata": {
      "key": "value"
    }
}'
How to specify the payout purpose​

In the description parameter, specify the following:

  • the transaction type (e.g. service fee)
  • the reason for the transaction (e.g. under Agreement No. 123)
  • the name of the products and/or services provided
  • whether or not VAT is applicable
  • for non-residents of the Russian Federation: a currency transaction code agreed with Bank 131

Restrictions:

  • disallowed characters: ?, !
  • maximum length:210 characters
Payout purpose example​

Wire for agreement № 5015553111 Ivanov Ivan Ivanovich VAT exempt