Request for getting a card synonym

In order to make a transfer to a bank card, you need to get the synonym of the bank card number. You can do it on the Yandex.Money's side or independently, by request.

To get the synonym independently, the Counterparty will need to place a form for entering card data on their website. After confirming input, the form data is sent using the POST method. The service processes the received data and uses the GET method to redirect the payer to the URL specified in skr_successUrl or skr_errorUrl. If successful, the synonym, mask, and additional parameters of the payer's card are appended to the URL.

Request parameters

Address for sending requests





xs:string, up to 25 characters

Bank card number.


xs:string, up to 8 characters

Format of the response to the request. Possible values: redirect or json. If the parameter is omitted, redirect is used by default.


xs:string, up to 250 characters

URL for redirecting in case of an error


xs:string, up to 250 characters

URL for redirecting in case of success

Code sample for a page for storing the card number on the Yandex.Money side and getting its synonym

        <form action= method=post>
        <input type=text name=skr_destinationCardNumber> <br>
        <input type=hidden name=skr_responseFormat value=redirect> <br>
        <input type=text name="skr_errorUrl" value=""> <br>
        <input type=text name="skr_successUrl" value=""> <br> 
        <input type=submit value="Save">

Parameters of the response to the request




Mandatory parameters

xs:string, up to 25 characters

Bank card mask


xs:string, up to 100 characters

Bank card synonym


xs:string, up to 100 characters

Result of data processing:

  • success if successful,
  • cardinvalid if failed.

Additional parameters


xs:string, up to 200 characters

Name of the card-issuing bank


xs:string, up to 3 characters

Numeric code of the card-issuing country


xs:string, up to 100 characters

Name of the card's payment system


xs:string, up to 1000 characters

Name of the card product


xs:string, up to 20 characters

Code of the card product

Example of a redirect format response


Example of a JSON format response for successfully saving the card number


Example of a JSON format response for failure to save the card number


The Counterparty uses the synonym of the card number received in the response from Yandex.Money deposit requests. Yandex.Money uses the received synonym to determine the recipient's card number.

See also

Deposits to bank card

Data types

Error codes