Payment acceptance by electronic certificate linked to a "Mir" card.

Manual integration:

Electronic certificate is a way to purchase certain types of products, works, and services (TRU) intended for those who receive social support from the state. For example, an electronic certificate can be used to purchase technical rehabilitation equipment.

An electronic certificate is a record in the digital registry of the State Information System of Electronic Certificates (GIS of ES). It contains information about products, works, and services that can be purchased using this certificate, as well as the limit amount and validity period of the certificate, and other details. This record is linked to the "Mir" card issued by any Russian bank.

Using an electronic certificate, its owner may purchase products or pay for a part of their cost in stores. The money can only be spent on the product or service specified in the certificate.

To process payments and refunds, the use of certificates should be pre-approved by the Electronic Certificates Front Office of the National Payment Card System (NSPK's FES).

Specify a list of products (TRU) that can be purchased by electronic certificates in your system. Each product should be assigned a special code (full product code consistent with the list of products, works, and services (TRU)).

When user makes a purchase, they create a shopping cart. It may contain products that can be purchased using certificates, and other products that need to be purchased by card. You create a shopping cart (according to the NSPK's FES) and select only those products that can be paid by certificate.

When user pays for products, they enter details of the "Mir" card linked to the certificate. This card and the list of products from the shopping cart shall be submitted to the NSPK's FES. You can do it independently or via YooMoney: process depends on your integration option.

The NSPK's FES authorizes the shopping cart by noting the products and their amount that can be reimbursed with the certificate.

Then YooMoney processes the payment: authorized amount is debited from certificate and remaining amount is debited from bank card.

Full and partial refunds are available. You can make a refund for both products purchased by electronic certificate and products purchased by card.

Refund processing time for electronic certificate depends on the GIS of ES. The certificate will be valid again when the transaction has been processed in the system. It takes about 1 to 3 days. If money isn't returned within this time, the user should contact the authority that issued the electronic certificate.

If the payment was made by bank card, the debiting term depends on the issuer. Money is usually returned within 3 days.

When you process payments made by electronic certificates, details of the created receipts shall be sent not only to the Tax Office but also to the NSPK. This applies to all receipts: payment receipts, refund payment receipts, correction receipts, etc.

The procedure depends on the way you create receipts: via YooMoney or independently:

Select the integration option you need:

Sign up for the Information Security Subsystem of the Russian Treasury. Add employees and grant them the required roles and rights. Add your company and a list of products purchased by certificate. Submit your data in the NSPK's FES personal account.

The link for registration in the NSPK's FES personal account will be sent to your email when you've signed up for the GIS of ES.

Add a sales register for your company in the NSPK's FES personal account. Learn more on the NSPK's website

When you add a sales register, select a vendor:

Get sales register's ID, MAC KEY, and API KEY.

Activate your company in the State Information System of Electronic Certificates. Learn more on the NSPK's website

Done! You can accept payments from real users.

When you process payments and refunds, you need to obtain the approval of the NSPK's FES for the use of electronic certificates and making refunds to them. To do this, you should submit information about your products: full product code according to a list of products, works, and services (TRU code), the name and code of the products in your system.

When and how this information should be submitted:

The full product code is needed to authorize a payment or refund in the NSPK's FES. The product code consists of the TRU code, the manufacturer's code, the model code, and the manufacturer's country code.

To create a TRU code, check the catalog of the technical rehabilitation equipment. The following actions depend on whether the product you need is in the catalog.

Copy the TRU code and bring it to the format: NNNNNNNNN.NNNNNNNNNYYYYMMMMZZZ.

Example:

Done! Use this code when you process payments and refunds.

Create the code independently. To do that, you need to:

Step 1. Find the product in the list of certain types of products, works, and services purchased by electronic certificate

Step 2. Copy the TRU code from the list.

Example: 329921120.060010102

Step 3. Add the manufacturer's code in the format: YYYY. If it's unknown, then add zeroes: 0000.

Examples:

Step 4. Add the model code in the format: MMMM. If it's unknown, then add zeroes: 0000.

Examples:

Step 5. Add the numeric code of the manufacturer's country according to the All-Russian Classification of Countries of the World (OKSM, OK (MK (ISO 3166) 004-97) 025-2001) in the format: ZZZ. If it's unknown, then add zeroes: 000.

Examples:

Done! Use this code when you process payments and refunds.

This product code is needed to authorize a payment or refund in the NSPK's FES. Format requirements can be found in the API reference .

If you process payments on the YooMoney's ready-made page, then this name will be displayed in the payment form. Format requirements can be found in the API reference .