Yandex.Money deposit

Yandex.Money is wallet payment method offered by Yandex.

The following method IDs are covered in this section:

ID	Name	Credit/Debit State
320	YandexMoneyDeposit	DepositedByProvider (29)

Payment method interaction type: Redirection to External Payment Provider (see Interaction Types).

User initiates a payment via Yandex.Money
Merchant sends initiatePaymentRequest to PXP Financial
PXP Financial sends payment request to Yandex
PXP Financial receives payment response with redirect URL
PXP Financial sends initiatePaymentResponse to the merchant with redirect URL included
User is redirected to Yandex to confirm the payment
After payment is confirmed user is redirected to 'return URL' and PXP Financial receive a notification
PXP Financial sends handlePaymentStateChangeNotification to the merchant

Redirect Integration

Currently not supported.

Backend2Backend Integration

The following parameters can be provided in initiatePaymentRequest.specificPaymentData:

key (value type, account type, required)	value
PaymentDescription (string)	Billing descriptor
PaymentDescriptionLanguageCode (string)	Two-digits language code. It's mandatory if PaymentDescription is provided.
HomePageUrl (string, required)	URL the user to be redirected after payment confirmation

Scenario: Successful Payment

Example initiatePaymentRequest:

<?xml version="1.0" encoding="utf-8"?>
<initiatePaymentRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cqrpayments.com/PaymentProcessing">
    <merchantID>KalixaAcceptDemo</merchantID>
    <shopID>KalixaAcceptDemo</shopID>
    <merchantTransactionID>e72da0b0-128c-49b7-9c96-004</merchantTransactionID>
    <paymentMethodID>320</paymentMethodID>
    <amount currencyCode="EUR">11.30</amount>
    <userID>6895456</userID>
    <userIP>127.0.0.1</userIP>
    <userSessionID>451afd0f-1e10-4608-bc8f-fb43987fdc45</userSessionID>
    <creationTypeID>1</creationTypeID>
    <specificPaymentData>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescription</key>
            <value>YandexMoneyDeposit 11.30 EUR</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>PaymentDescriptionLanguageCode</key>
            <value>EN</value>
        </data>
        <data xsi:type="keyStringValuePair">
            <key>HomePageUrl</key>
            <value>home.com</value>
        </data>
    </specificPaymentData>
</initiatePaymentRequest>

Example initiatePaymentResponse:

<initiatePaymentResponse xmlns="http://www.cqrpayments.com/PaymentProcessing" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xsi:type="paymentWithPaymentAccount">
        <merchantID>KalixaAcceptDemo</merchantID>
        <shopID>KalixaAcceptDemo</shopID>
        <paymentMethod>
            <key>320</key>
            <value>YandexMoneyDeposit</value>
        </paymentMethod>
        <merchantTransactionID>e72da0b0-128c-49b7-9c96-28.12.2018-004</merchantTransactionID>
        <paymentID>b4875675-fb38-40c9-95d9-e2f21fd273c7</paymentID>
        <userID>6895456</userID>
        <paymentProvider>
            <key>177</key>
            <value>Yandex</value>
        </paymentProvider>
        <amount currencyCode="EUR">11.30</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>7bc8a1fd-a578-4e83-84f4-34bde513c9d7</id>
            <definition>
                <key>30</key>
                <value>RedirectURLCreated</value>
            </definition>
            <createdOn>2018-12-28T09:26:50.3551898Z</createdOn>
            <description>https://money.yandex.ru/payments/internal/confirmation?orderId=2da8d60e-a44f-459a-879b-ada8d26975b4</description>
            <paymentStateDetails>
                <detail xsi:type="keyStringValuePair">
                    <key>RedirectionUrl</key>
                    <value>https://money.yandex.ru/payments/internal/confirmation?orderId=2da8d60e-a44f-459a-879b-ada8d26975b4</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>ProviderResponseCode</key>
                    <value>pending</value>
                </detail>
                <detail xsi:type="keyStringValuePair">
                    <key>PaymentStateReasonID</key>
                    <value>1</value>
                </detail>
            </paymentStateDetails>
        </state>
        <isExecuted>false</isExecuted>
        <baseAmount currencyCode="EUR">11.30</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>2da8d60e-a44f-459a-879b-ada8d26975b4</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>26286031</value>
            </detail>
        </paymentDetails>
    </payment>
</initiatePaymentResponse>

Notifications

The standard notification mechanism is used for notifying the merchant in the background (asynchronously) about payment state changes. For more information see PaymentStateChangedNotification.

Scenario: Successful Payment Notification

<?xml version="1.0" encoding="utf-16"?>
<handlePaymentStateChangedNotificationRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <payment xmlns:q1="http://www.cqrpayments.com/PaymentProcessing" xsi:type="paymentWithPaymentAccount">
        <merchantID>KalixaAcceptDemo</merchantID>
        <shopID>KalixaAcceptDemo</shopID>
        <paymentMethod>
            <key>320</key>
            <value>YandexMoneyDeposit</value>
        </paymentMethod>
        <merchantTransactionID>e72da0b0-128c-49b7-9c96-28.12.2018-004</merchantTransactionID>
        <paymentID>b4875675-fb38-40c9-95d9-e2f21fd273c7</paymentID>
        <userID>6895456</userID>
        <paymentProvider>
            <key>177</key>
            <value>Yandex</value>
        </paymentProvider>
        <amount currencyCode="EUR">11.30</amount>
        <creationType>
            <key>1</key>
            <value>User</value>
        </creationType>
        <userIP>127.0.0.1</userIP>
        <state>
            <id>9bba89f4-5b2b-4883-9433-2cc6b416e7ab</id>
            <definition>
                <key>29</key>
                <value>DepositedByProvider</value>
            </definition>
            <createdOn>2019-01-04T09:38:20.31</createdOn>
            <paymentStateDetails xsi:nil="true" />
        </state>
        <isExecuted>true</isExecuted>
        <baseAmount currencyCode="EUR">11.30</baseAmount>
        <paymentDetails>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderExternalID</key>
                <value>26336110</value>
            </detail>
            <detail xsi:type="keyIntValuePair">
                <key>MerchantSettlementCurrencyID</key>
                <value>2</value>
            </detail>
            <detail xsi:type="keyStringValuePair">
                <key>ProviderTransactionID</key>
                <value>2da8d60e-a44f-459a-879b-ada8d26975b4</value>
            </detail>
        </paymentDetails>
        <paymentAccount>
            <paymentAccountID>04f185e4-25e3-43b7-932f-1e82a69ca687</paymentAccountID>
            <details>
                <detail xsi:type="keyStringValuePair">
                    <key>accountNumber</key>
                    <value>410011758831136</value>
                </detail>
            </details>
        </paymentAccount>
    </payment>
</handlePaymentStateChangedNotificationRequest>