# Robokassa

Приём платежей — генерация ссылок, статус платежа, фискальные чеки (54-ФЗ)

## Scenarios

### A payment link right in the chat
The agent builds a payment link with the amount, the description and a 54-FZ fiscal receipt — ready to send to the customer straight away.

### Status of an issued invoice
The agent tells you by invoice number where the payment stands: initiated, on hold, paid or refunded — without opening the merchant account.

### Reminders on unpaid invoices
On a schedule the agent walks through the invoices it issued and reminds you about the ones that are still unpaid.

### Currencies and payment methods
The agent shows the currencies and payment methods available to your shop, so a link is issued in whatever is convenient for the customer.

## How to connect

### Create a shop in your Robokassa merchant account
Register at partner.robokassa.ru and create a shop — the identifier and passwords exist only for a shop. Until the shop is activated, live payments fail with error 25 ("shop not activated").

### Open «Мои магазины» → «Технические настройки»
The shop identifier (MerchantLogin) sits in the shop card under «Мои магазины» → «Технические настройки» (My shops → Technical settings). It is the shop login, not your account e-mail; a typo returns error 26.

### Make sure the hash algorithm is MD5
The signature hash method is chosen in the shop's technical settings; MD5 is the default and the integration signs requests exactly that way. If the shop is set to SHA-256 or another algorithm, switch it back to MD5.

### Copy the live Password #1 and Password #2
The same section holds two password blocks, live and test. Take the live pair: Пароль #1 (Password #1) signs the payment, Пароль #2 (Password #2) signs notifications and status requests. Test passwords return error 29.

## FAQ

### How do I connect Robokassa?
With three values from My shops, Technical settings: the shop identifier (this is the shop login, not the sign-in e-mail), password #1 and password #2. Check that the hash algorithm is MD5, otherwise signatures will not match, and test passwords will return error 29.

### What does the agent do with payments?
It builds payment links with a 54-FZ fiscal receipt, checks the status of an invoice by its number and shows the currencies and payment methods available to the shop.

### This is not a settlement account, is it?
No. Robokassa is about accepting payments from customers: the agent sees issued invoices and their statuses, not a bank account statement. For account operations a bank is connected as a separate connector.

### What about money and permissions?
The agent does not handle money: it issues an invoice and reads its status, while crediting and withdrawal stay on the Robokassa side and under your contract with them.

[Open Robokassa](https://partner.robokassa.ru/Shops)
