Form for email notifications

Address for form submission

https://money.yandex.ru/eshop.xml

Form parameters

ParameterTypeRestrictionsDescription
Required parameters

shopId

long

The merchant ID issued when activating Yandex.Checkout.

scid

long

The merchant's number, issued when activating Yandex.Checkout.

sum

CurrencyAmount

Order amount.

customerNumber

normalizedString

64 characters

The customer ID used by the merchant. The ID can be the customer's contract number, username, or other.

The same customer ID can be used repeatedly in payments.

Optional parameters

orderNumber

normalizedString

64 characters

Unique number in the merchant's system. Yandex.Checkout ensures that this number is unique in conjunction with the shopId parameter.

If a payment with the same order number was already successfully processed, Yandex.Checkout will decline repeat payment attempts.

shopArticleId long

Product ID. Issued when activating Yandex.Checkout. Used if the store has multiple payment forms for various products.

shopSuccessURL

string, URL path

250 characters

The URL for the Back to store link on the successful payment page. You must enable dynamic URL processing with Yandex.Checkout (ask your manager) for this parameter to be processed.

shopFailURL

string, URL path

250 characters

The URL for the Back to store link on the payment error page. You must enable dynamic URL processing with Yandex.Checkout (ask your manager) for this parameter to be processed.

cps_email

string

100 characters

Payer's email address. If it is passed, the corresponding field on the payment confirmation page will be pre-filled (step 3 on the payment flow).

You can transmit only email address (we check it).

cps_phone

string

15 characters, digits only

Payer's mobile phone number. If passed, the corresponding box on the payment confirmation page will be pre-filled (step 3 in the payment process). The phone number is used for paying cash via payment kiosks.

paymentType

normalizedString 5 characters

The payment method. We recommend passing an empty value in this field so that the payment method will be selected in Yandex.Checkout.

Examples:

  • PC - Payment from a Yandex.Money Wallet.
  • AC - Payment from any bank card.

Full list of values

Restriction. 

If the payment form specifies a payment method that is not allowed for the merchant, the customer can't complete the payment.

custName string Payer's full name
custAddr string Delivery address or the payer's home address
custEmail string Payer's email address, only for sending email notifications
orderDetails string Order details: a list of purchased products, quantities, payment designation, and so on.
ym_merchant_receipt string

Details for creating a receipt in the JSON format.

The parameter is transmitted and presents as mandatory if you set up interaction with your online sales register via Yandex.Checkout and transmits the details for creating the receipt in the payment form.

See Parameters for creating a receipt

Examples

Example of the payment form
<form action="https://money.yandex.ru/eshop.xml" method="post">
    <input name="shopId" value="1234" type="hidden"/>
    <input name="scid" value="4321" type="hidden"/>
    <input name="sum" value="100.50" type="hidden">
    <input name="customerNumber" value="abc000" type="hidden"/>
    <input name="shopArticleId" value="567890" type="hidden"/>
    <input name="paymentType" value="AC" type="hidden"/>
    <input name="orderNumber" value="abc1111111" type="hidden"/>
    <input type="text" name="cps_email" value="user@domain.com">
    <input type="text" name="cps_phone" value="79009009090">
    <input name="custName" value="Adam Boris Johnson" type="hidden"/> 
    <input name="custEmail" value="user@domain.com" type="hidden"/> 
    <input name="custAddr" value="Moscow, POB 100" type="hidden"/> 
    <input name="orderDetails" value="Happiness for all. Bulk, in bags." type="hidden"/> 
 <input type="submit" value="Pay"/>
</form>
Note. 

The page Email notifications of payments shows how payment form parameters correspond to fields from payment notificationsEmail notifications of payments.

This page also has an example of an email notification.

See also

Email notifications of payments

Testing payment