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).

  1. User initiates a payment via Yandex.Money
  2. Merchant sends initiatePaymentRequest to PXP Financial
  3. PXP Financial sends payment request to Yandex
  4. PXP Financial receives payment response with redirect URL
  5. PXP Financial sends initiatePaymentResponse to the merchant with redirect URL included
  6. User is redirected to Yandex to confirm the payment
  7. After payment is confirmed user is redirected to 'return URL' and PXP Financial receive a notification
  8. 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>