Testing — Protocol for deposits to YooMoney wallets

Testing deposits

Before sending requests containing real data, you can check your integration using special test data. The testing process is identical to the actual payout process, except the money is not transferred anywhere.

Preparing for testing

Step 1. Obtain the required certificates

Obtain the required certificates for interacting with YooMoney.

Step 2. Wait until you get a test gateway

After entering into contract for payment acceptance, your YooMoney manager will provide a test gateway to you. The test gateway is similar to the real one. The main difference is that its only used for test deposits and you don’t need to add money to its balance.

For testing, you’ll need to find out the test gateway’s agentId and use it in all requests to YooMoney.

The test gateway and the real gateway have different agentId parameters. You can’t use the agentId of the real gateway for testing: YooMoney will return the 41 error code.

Step 3. Wait for the email from your YooMoney manager

Your YooMoney manager will contact you via email and confirm that everything is properly configured and you can start testing.

Testing deposits to wallets

When everything is ready, you can test:

When sending requests, use special test data.

URL of the server for sending requests

https://deposit.yoomoney.ru:9094

After verification, set your system up for processing real deposit.

Testing the successful scenario

You can run a test for a successful deposit. To do that, send a request with the agentId of the test gateway, deposit amount (1 ruble or more) and dstAccount with the number of a test YooMoney wallet (4100322407607) or test payment code (25700138690138403).

If you want to make a test deposit to a YooMoney wallet with a certain status, send the corresponding test number in dstAccount:

Test wallet status	Test wallet number (dstAccount)
Anonymous	41001614575714
Reviewed	4100116075156746
Identified	4100116074720387

Testing scenario:

Check if it’s possible to make transfers (testDeposition).
Credit the transfer (makeDeposition).
Credit the transfer again by repeating makeDeposition using the same data.
Check the balance (balance).

Testing the unsuccessful scenario

You can check the processing of deposit errors on wallets. To do this, select the scenario you need and send a makeDeposition request with a special test wallet number and a certain amount of crediting.

Transfer error description	Test wallet number (dstAccount)	Transfer amount
`41` YooMoney wallet blocked. This operation is not allowed for this wallet.	410011788545536	1 ruble or more
`42` There is no account with this ID	410011806060695	1 ruble or more
`43` Exceeded the limit on a one-time transfer, or the limit on the recipient’s account balance	41001614575572	1 ruble or more
`44` Exceeded the limit on the maximum amount of deposits per day	41001614575643	1 ruble or more
`45` Not enough funds to perform the operation	410011806060766	1 ruble or more
`46` The transaction amount is too small	41001614575714	Less than 1 ruble
`57` This YooMoney wallet is not identified. Adding money to anonymous wallets is forbidden. The user needs to complete identification.	4100116103609421	1 ruble or more

Processing real deposits

Contact your manager to make sure everything is ready. After that, send requests with the ID of the real gateway (agentId) and real data.

The test gateway and the real gateway have different agentId parameters. You can't use the agentId of the test gateway for real deposits: YooMoney will return the 41 error code.