Email Protocol: Simple Onboarding

An easy onboarding option: copy the prepared code lines from this page and put in it the parameters you received upon signing up. Embed the prepared code lines into the site—you will need elementary understanding of HTML.

For this method, we send notifications about payments at the email address your provided upon signing up. You receive separate email on every successful payment.

Capacities

Payment methods available: all but loans.

Additional features unavailable: setting up autopayments, linking bank cards, and providing preauthorization. On the plus side, you will be able to issue invoices to your clients via email.

Activating

Step 1. Fill out application

Fill out an application for implementing Yandex.Checkout. You will get access to your Merchant Profile.

Step 2. Select implementation method

  1. Sign in your Merchant Profile and push Fill out under the Settings section.
  2. Select Email protocol as your implementation method and push Proceed.
  3. Specify the email address you want to receive notifications on successful payments at.
  4. Push Send.

You will get a message with parameters for work: shopId and scid.

Step 3. Create payment form

1. Use our form sample.

<!-- Sample of headers on the payment page that you can show to your users -->
    <h1>Product Name</h1>
    <div>Price: 1 rub.</div><hr>
     
<!-- Payment form
     These fields are mandatory, do not remove them. -->
    <form action="https://money.yandex.ru/eshop.xml" method="post">
    <input name="shopId" value="enter-your-shopId-value-here" type="hidden" required/>
    <input name="scid" value="enter-your-scid-value-here" type="hidden" required/>
    To be paid<br>
    <input name="sum" value="" type="number" min="1" placeholder="0.0" required><br><br>
     
<!-- The field name="customerNumber" is mandatory, do not remove it.
     This field allows you to understand who made the payment.
     You can assign this field any name you like. For instance, instead of 'Buyer's name' you can write
     'Payer's identifier', 'Client's number', 'Name of the client', or 'Order number'. -->
     Buyer's name<br>
     <input required name="customerNumber" value="" size="64"/><br><br>
 
<!-- You can delete or rename these fields.
     For instance, instead of 'Buyer's phone number' you can enter 'Eyes color' or 'Vehicle number'.  -->
     Buyer's phone number<br>  
     <input name="custName" value="" size="64"/><br><br>
     Delivery address<br>  
     <input name="custAddr" value="" size="64"/><br><br>
     Buyer's email address<br>   
     <input name="custEmail" value="" size="64"/><br><br>
     Commentary to the order<br>   
     <textarea name="orderDetails" value="" rows="5" cols="64" wrap="soft"></textarea><br><br> 
 
<!-- You can rename the button "Pay" as you like.
     For instance, 'Pay for subscription' or 'Deposit money'-->
     <input type="submit" value="Pay">
     </form>

See documentation for details

How the form looks like

2. Set your own parameters.

Be sure to use your shopId (identifier of your store) and scid (identifier of your showcase). Request them from your manager or copy them from your Merchant Profile.

Specify your shopId instead of XXXX:

<input name="shopId" value="XXXX" type="hidden" required/>

What should be:

<input name="shopId" value="1234567" type="hidden" required/>

Sample of prepared form

<!-- Sample of headers on the payment pages you can view to users -->
    <h1>HyperDrive</h1>
    <div>Price: 100 rub.</div><hr>
     
    <form action="https://money.yandex.ru/eshop.xml" method="post">
    <input name="shopId" value="1234567" type="hidden" required/>
    <input name="scid" value="12345" type="hidden" required/>
    To be paid<br>
    <input name="sum" value="" type="number" min="1" placeholder="0.0" required>
     
     Buyer's name<br>
     <input required name="customerNumber" value="" size="64"/><br><br>
    
     Buyer's phone number<br>  
     <input name="custName" value="" size="64"/><br><br>
 
     Commentary to the order<br>   
     <textarea name="orderDetails" value="" rows="5" cols="64" wrap="soft"></textarea><br><br>
 
     <input type="submit" value="Pay">
     </form>

The parameters used in your payment form determine contents of an email about payment.

Step 4. Place the form on the site

Insert the form's code into your site's source code near the product or service which you will accept money for.

Step 5. Conduct testing

Check how everything functions: try payment via this form.

For testing payments, you can set minimum price amount (sum parameter). It is crucial to set this amount within the limits for your payment method. For instance, you can pay minimum 1 rubles from a bank card.

Make sure of the following:

  • the payment is made without errors: you can see a page with a green tip and payment results
  • you received an email about the payment to your email address.

Email about Payment

We send such email messages after every successful payment at the address you provided upon signing up. The message includes values of the following parameters from the payment form:

  • sum and customerNumber are mandatory

  • custName, custAddr, custEmail, and orderDetails are optional: deleting them will mean these fields will be empty in the message.

From: Yandex.Money Demo Payment Center <paymentcenter@yamoney.ru>
Subject: Yandex.Dengi payment for Your-company-name #56
------------------------------------------------------------------
Notification No. 56
Recipient: Your-company-name
Payment time: 23.10.2016 18:24:09
Amount: 1000.00 RUB
Transaction number: 2000000942259
Client's identifier: <What the payer enters in the customerNumber field>
Number in the store: 2000000942259
Filled in by the payer in the payment form of the store:
Full name: <The value of custName field from the payment form>
Delivery address: <The value of custAddr field from the payment form>
Email: <The value of custEmail field from the payment form>
Order contents:
<The value of orderDetails field from the payment form>
------------------------------------------------------------------------------