HTML forms

Four HTML forms and two Callbacks are used to transmit data between the merchant's website and the service:

Payment request form is generated on the merchant's website in order to request a payment in Merchant WebMoney.eu Service and transfer it through the customer's browser.
Payment Request Form Content Language is GET-parameter "lang" that allows you to save the desired content language in the Payment Request Form.
Callback at submitting check information is generated once the customer has submitted the check information and it has been verified, but the customer has not confirmed the purchase yet.
Callback at confirming the payment is generated once the customer has submitted the check information, it has been verified and the customer confirmed the purchase.
Payment notification form is generated by Merchant WebMoney.eu Service in order to notify the merchant about the payment. The customer's browser is not used during the transmission of payment notification to the merchant's website.
Payment success form is created by WebMoney.eu Merchant and in case a payment is completed successfully it is transmitted to the seller’s website via the customer’s browser.
Failed payment form is created by WebMoney.eu Merchant in case the payment was a failure and is transmitted to the seller’s website via the customer’s browser.

Payment Request Form

This form is generated by the merchant system and is sent to the WebMoney.eu Merchant service via the customer's browser. It has the following fields and properties:
Action - https://www.webmoney.eu/merchant/PayTask.mvc/Execute
Method - POST, GET
Fields - The following table describes the fields on this form ( PM_PAYMERCH_ID and PM_PAYMENT_NO are required fields):

Merchant ID - PM_PAYMERCH_ID
Payment amount - PM_PAYMENT_AMOUNT
Currency type - PM_PAYMENT_ATYPE
Merchant Reference Number - PM_PAYMENT_NO
Payment purpose - PM_PAYMENT_DESC
Test Mode Flag - PM_PAYTEST_MODE
Result URL Override - PM_PAYRESULT_URL
URL Override
URL Method Override
Merchant Parameters

Field name

HTML Field Name

Merchant ID

PM_PAYMERCH_ID

Unique number of the merchant.

Field name

HTML Field Name

Payment Amount

PM_PAYMENT_AMOUNT

The amount that the merchant wishes to be paid by the customer. The amount must be greater than zero, and a dot (.) is used as decimal delimiter.

Field name

HTML Field Name

Currency Type

PM_PAYMENT_ATYPE

The type of the currency that the customer paid. Only currency types valid in the WebMoney.eu system must be used

Field name

HTML Field Name

Merchant Reference Number

PM_PAYMENT_NO

A field that the merchant can specify to associate the customer order with. Though this filed is not required, the WebMoney.eu Merchant service recommends merchants to always specify it to identify and keep track of each order. Merchants should use a unique number for each order in order to be able to get information on it via other WebMoney.eu Merchant interfaces.
The field must contain an integer.The maximum length allowed for this field is 9 digits.

Field

HTML Field Name

Payment Purpose

PM_PAYMENT_DESC

Product or service description specified by the merchant.
If specified, it must be added to a WM transaction purpose.
The maximum length allowed for this field is 255 characters.

Field name

HTML Field Name

Test Mode Flag

PM_PAYTEST_MODE

An additional field indicating the type of payment simulation the merchant wants to effect in Test mode. It can take one of the following values ( PM_PAYTEST_MODE - PM_PAYTEST_MODE = "1" by default and if values different from those below are specified)
*If the Merchant is not set to Test, the PM_PAYTEST_MODE will be ignored.

0 - All simulated payments will fail.

1 - All simulated payments will succeed.

2 - Approximately 80% of simulated payments will succeed.

Field name

HTML Field Name

Result URL Override

PM_PAYRESULT_URL

This field enables the merchant to temporarily override the Result URL property as set by the merchant on the WebMoney.eu Merchant Settings page.
If the value of the Allow URL Overrides from the Form property is set to true, then the value of this field will be used in place of the Result URL set by the merchant. Otherwise the value set by the merchant on the WebMoney.eu Merchant Settings page will be used.
The format of this field must coincide with the format of the Result URL field.

Field name

HTML Field Name

URL Override

PM_PAYSUCCESS_URL
PM_PAYFAIL_URL
PM_PAYPAY_URL
PM_PAYREQUEST_URL
PM_PAYRESULT_URL

This field enables the merchant to temporarily override the URL property (for a certain event) as set by the merchant on the WebMoney.eu Merchant Settings page.
If the property is set to Allow URL Overrides, then the value of this field on the form will be used in place of the event URL set by the merchant on the WebMoney.eu Merchant website. Otherwise the value set by the merchant on the WebMoney.eu Merchant Settings page will be used.
The format of this field must coincide with the format of the event URL field.

Field name

HTML Field Name

URL Method Override

PM_PAYSUCCESS_METHOD
PM_PAYFAIL_METHOD
PM_PAYPAY_METHOD
PM_PAYREQUEST_METHOD
PM_PAYRESULT_METHOD

This field enables the merchant to temporarily override the URL method property (for a certain event) as set by the merchant on the WebMoney.eu Merchant Settings page.
If the property is set to Allow URL Method Overrides, then the value of this field on the form will be used in place of the event "URL Method" set by the merchant on the WebMoney.eu Merchant website. Otherwise the value set by the merchant on the WebMoney.eu Merchant Settings page will be used.
The value of this field can be set to "GET" or "POST".

Note: Your have to specify *_URL and *_METHOD to override the notification of the event. An error occurs when you specify only one *_URL parameter without parameter *_METHOD

Field name

HTML Field Name

Merchant Parameters

As specified by the merchant

All merchant-specific fields as specified by the merchant that do not start with "PM_PAY". These fields are processed by the WebMoney.eu Merchant service automatically and are passed to the merchant's website once the payment is made.

Payment Request Form Content Language

Language tags are abbreviated language codes. For example: a primary tag identifies the language "en" for English and an optional tag in capital letters specifies the national variety "US". The tags are linked with a hyphen - “en-US” (American English).

GET-parameter "lang" allows you to save the desired content language in the Payment Request Form. At this time three content languages are supported: English "en-US", Russian "ru-RU" and Ukrainian "uk-UA".

Action - change the language parameters in "lang=en-US" to desired.

Example - action="https://www.webmoney.eu/merchant/PayTask.mvc/Execute?lang=en-US"

Callback at Confirming the Payment

Pay: Once the customer has submitted the check information, it has been verified and the customer confirmed the purchase, a confirmation message on the customer’s wish to buy the product is sent to the merchant’s website. The merchant’s website will return the confirmation of the merchant’s desire to sell the product.
Action - Pay URL

Method - POST

Fields - The following table describes the fields on this form:

Field name HTML Field Name

Merchant ID PM_PAYMERCH_ID

Unique number of the merchant that the payment was made to. Format: an integer.
*This field is required.

Field name HTML Field Name

Payment Amount
PM_PAYMENT_AMOUNT

The amount that the customer paid to the merchant; a dot(.) is used as decimal delimiter.

Field name HTML Field Name

Currency Type PM_PAYMERCH_ATYPE

The type of the currency that the customer paid. Only currency types valid in the Paymer system must be used.

Field name HTML Field Name

Merchant Reference Number PM_PAYMENT_NO

A field that the merchant can specify to associate the customer order with. The reference number is associated with the purchase made by the customer. It is received from the merchant's website.

Field name HTML Field Name

Test Mode Flag PM_PAYTEST_MODE

This field indicates whether the payment was real or test:

0: Switches to live mode - Payment was real; funds were transferred from the customer's check to the merchant's Paymer account;

1: switches to test mode - Payment was simulated.

Callback at Submitting Check Information

Request: Once the customer has submitted the check information and it has been verified, but the customer has not confirmed the purchase yet, a confirmation message is sent to the merchant’s website. The merchant’s website will return the confirmation of the merchant’s desire to sell the product.
Action - Request URL

Method - POST

Fields - The following table describes the fields on this form:

HTML Field Name Description

Merchant ID PM_PAYMERCH_ID

Unique number of the merchant that the payment was made to. Format: an integer.
*This field is required.

Field name HTML Field Name

Payment Amount
PM_PAYMENT_AMOUNT

The amount that the customer paid to the merchant; a dot(.) is used as decimal delimiter.

Field name HTML Field Name

Currency Type PM_PAYMERCH_ATYPE

The type of the currency that the customer paid. Only currency types valid in the Paymer system must be used.

Field name HTML Field Name Description

Test Mode Flag PM_PAYTEST_MODE

This field indicates whether the payment was real or test:

0: Switches to live mode - Payment was real; funds were transferred from the customer's check to the merchant's Paymer account;

1: switches to test mode - Payment was simulated.

Payment Notification Form

This form is sent by the WebMoney.eu Merchant interface to the merchant system once a payment has been made:

Action - Result URL

Method - POST

Fields - The following table describes the fields on the Payment Notification Form:

Merchant ID - PM_PAYMERCH_ID
Payment amount - PM_PAYMENT_AMOUNT
Currency type- PM_PAYMENT_ATYPE
Merchant Reference Number - PM_PAYMENT_NO
Test/Live Mode Flag - PM_PAYTEST_MODE
Transaction ID - PM_PAYSYS_TRANS_NO
Payment Details Hash - PM_PAYHASH
Transaction Date and Time - PM_PAYSYS_TRANS_DATE
Secret Key - PM_PAYSECRET_KEY
Merchant Parameters
Very Important

Field name

HTML Field Name

Merchant ID

PM_PAYMERCH_ID

Unique number of the merchant that the payment was made to. Format: an integer.
*This field is required.

Field name

HTML Field Name

Payment Amount

PM_PAYMENT_AMOUNT

The amount that the customer paid to the merchant; a dot(.) is used as decimal delimiter.

Field name

HTML Field Name

Currency Type

PM_PAYMERCH_ATYPE

The type of the currency that the customer paid. Only currency types valid in the Paymer system must be used.

Field name

HTML Field Name

Merchant Reference Number

PM_PAYMENT_NO

A field that the merchant can specify to associate the customer order with. The reference number is associated with the purchase made by the customer.

Field name

HTML Field Name

Test Mode Flag

PM_PAYTEST_MODE

This field indicates whether the payment was real or test:

0: Switches to live mode - Payment was real; funds were transferred from the customer's check to the merchant's Paymer account;

1: switches to test mode - Payment was simulated.

Field name

HTML Field Name

Transaction ID

PM_PAYSYS_TRANS_NO

The unique WebMoney.eu Merchant transaction ID that is associated with the payment.
*This field must be used to verify the source and integrity of other fields

Field name

HTML Field Name

Payment Details Hash

PM_PAYHASH

A hash of the payment notification details used to verify the source and integrity of payment details.
The algorithm is described in "Payment details hash".

Field name

HTML Field Name

Transaction Date and Time

PM_PAYSYS_TRANS_DATE

The date and time that the WebMoney.eu Merchant system effected the payment, in the format
"YYYYMMDD HH:MM:SS".

Field name

HTML Field Name

Secret Key

PM_PAYSECRET_KEY

The Secret Key that is only known by the merchant and the WebMoney.eu Merchant system.
This field will always be empty, if the Send Secret Key to Result URL property is set to indicate that it should not be sent.
*read more about Secret Key here >>

Field name

HTML Field Name

Merchant Parameters

As specified by the merchant

All merchant-specific fields as specified by the merchant on the " Payment Request Form" (of which the field names do not start with "PM_PAY").

Note that
the merchant must verify both the source and the integrity of the above payment notification details sent in the Payment Notification Form as described in "Payment Details Hash ".

Payment Failure Form

This form submits payment details to the merchant system if the WebMoney.eu Merchant system was unable to effect a successful payment. This form is submitted via the customer's browser if "GET" or "POST" Success URL method is set. It has the following properties and fields:

Action - Fail URL

Method - Fail URL method

Payment Success Form

This form submits payment details to the merchant system, if a successful payment was made. This form is submitted via the customer's browser if "GET" or "POST" Success URL method is set. The following table describes the fields on the Payment Success Form:

Action - Success URL

Method - method used to send the form to Success URL

Fields - fields on the Payment Success Form:

Field name HTML Field Name Description

Merchant Reference Number PM_PAYMENT_NO A field that the merchant can specify to associate the customer order with. The reference number will be included in the data associated with the payment. The reference number is received from the merchant's website.

Merchant Number in the WebMoney.eu Merchant system PM_PAYMERCH_ID The unique number of the merchant that the payment must be made to by the customer. The customer gets this number when the request is processed by the WebMoney.eu Merchant system.

Transaction ID in the WebMoney.eu Merchant system PM_PAYSYS_TRANS_NO The unique WebMoney.eu Merchant transaction ID that is associated with the payment.

Payment amount PM_PAYMENT_AMOUNT The amount that the merchant wishes to be paid

Currency type PM_PAYMENT_ATYPE The type of the currency that the above amount is specified in.

Test/Live Mode PM_PAYTEST_MODE Indicates whether the payment is real or test (simulated), its value is "1" if the payment was simulated and 0 if a real payment was made.

Transaction Date and Time PM_PAYSYS_TRANS_DATE The date and time that the WebMoney.eu Merchant system effected the payment, in the format "YYYYMMDD HH:MM:SS".

Merchant Parameters As specified by the merchant All remaining fields (of which the field names do not start with "PM_PAY") that the merchant may have specified on the "Payment Request Form".

The following is an example of "Payment Success Form"

<html>
<head>
...
</head>
<body>
...
<form method="<Success URL method>" action="<Success URL>">
<input type="hidden" name="PM_PAYMENT_NO" value="1">
<input type="hidden" name="PM_PAYMERCH_ID" value="679">
<input type="hidden" name="PM_PAYSYS_TRANS_NO" value="558">
<input type="hidden" name="PM_PAYTEST_MODE" value="0">
<input type="hidden" name="PM_PAYSYS_TRANS_DATE" value="20020314 14:01:14">
<input type="hidden" name="PM_PAYMENT_AMOUNT" value="100.23">
<input type="hidden" name="PM_PAYMENT_ATYPE" value="EUR">
<input type="hidden" name="FIELD_1" value="VALUE_1">
<input type="hidden" name="FIELD_2" value="VALUE_2">
...
</form>
..
</body>
</html>