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 YooMoney. You will get access to your Merchant Profile.
Step 2. Select implementation method
- Sign in your Merchant Profile and push Fill out under the Settings section.
- Select Email protocol as your implementation method and push Proceed.
- Specify the email address you want to receive notifications on successful payments at.
- Push Send.
You will get a message with parameters for work: shopId and scid.
Step 3. Create payment form
- Use our form template.
<!-- Example of headers on the payment page that may be displayed to the user --> <h1>Product name</h1> <div>Price: 1 rub.</div><hr> <!-- Payment form These fields are mandatory, you cannot remove them. --> <form action="https://yoomoney.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 name="customerNumber" field is required and can't be removed. It will help you understand who has made the payment. You can use any name for this field. For example, instead of "Customer's name", you can specify "Payer ID", "Customer number", "Customer name", or "Order number". --> Customer's name<br/> <input required name="customerNumber" value="" size="64"/><br/><br/> <!-- These fields may be removed or renamed. For example, instead of "Customer's phone number", you can specify "Eye color" or "License plate number". --> Customer's phone number<br/> <input name="custName" value="" size="64"/><br/><br/> Delivery address<br/> <input name="custAddr" value="" size="64"/><br/><br/> Customer'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/> <!-- The "Pay" button can be named anything you need. For example, "Pay for subscription" or "Add money"--> <input type="submit" value="Pay"> </form>What the form looks like - 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<!-- Example of headers on the payment page that may be displayed to the user --> <h1>Spare part</h1> <div>Price: 100 rub.</div><hr> <form action="https://yoomoney.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/> Customer's name<br/> <input required name="customerNumber" value="" size="64"/><br/><br/> Customer'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 (parameter sum). 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:
sumandcustomerNumberare mandatorycustName,custAddr,custEmailиorderDetailsare optional: deleting them will mean these fields will be empty in the message.
From: YooMoney Payment Center <paymentcenter@yoomoney.ru> Subject: YooMoney payment for Your-company-name #56 ------------------------------------------------------------------ Notification No. 56 Recipient: Your-company-name Date of payment: 23.10.2016 18:24:09 Amount: 1,000.00 RUB Transaction number: 2000000942259 Client identifier: <What the customer specifies in the customerNumber field> Number in the store: 2000000942259 Filled out by the customer in the store's payment form: Full name: <Value of the custName field from the payment form> Delivery address: <Value of the custAddr field from the payment form> Email: <The value of the custEmail field from the payment form> Contents of the order: <The value of the orderDetails field from the payment form> ------------------------------------------------------------------------------