DengiOnline

2017-07-29 03:33:36

Invoicing in case of complete integration (general procedure)

In case of Complete Integration the interaction between the System and the Project follows a complete procedure:

  • the User selects goods or services at the Project web-site and clicks Pay;
  • the User can choose a payment mode and the Payment system as well as enter information necessary for the payment;
  • after receiving necessary data from the User the Project transfers the payment data to the System.

Request Parameters

Initial link for requests: https://www.onlinedengi.ru/wmpaycheck.php

To send the request use the following rules:

  • method - GET/POST
  • format - XML
  • encoding - windows-1251 
Parameter Description Format Mandatory

project

Project ID received during integration

int

Yes

mode_type

Payment mode and currency code

code according to the table

Yes

amount 

Payment amount in the currency of the selected Payment System or in the currency specified in the paymentCurrency parameter (see below)

decimal(10.2),  delimiter — decimal point

Yes

paymentCurrency

Account currency

Possible values: USD, RUB, EUR, UAH

string

ISO 4217alfa-3

Yes

 

nickname 

User or Order ID. In the majority of Payment Systems this parameter is used as the payment description/purpose. If the Project does not use User or Order IDs, then the parameter may have any arbitrary value.

string(255)

Yes

order_id

Payment ID in the Project system

string(64)

Yes

comment 

Payment comments in text form. This parameter substitutes for the nickname when the payment description/purpose is filled in.

string (500)

No

nick_extra

Additional information necessary for the payment or statistic gathering on the Project side.

string (500)

No

return_url_success

URL-address used to redirect the user back to the Project site after successful invoice creation/settlement.

http://dengionline.com/success

No

return_url_fail

URL-address used to redirect the user back to the Project site in case of invoice creation/settlement failure.

http://dengionline.com/fail

No

Note! The System receives the data and checks their format and completeness. If some obligatory data are missing the user will be redirected to the System site and will receive an error message. In case the Project has provided a payment error page URL-address, the user will be redirected to this page within the Project.

Then the System requests from the Project to confirm received User and Order IDs, using pre-check URL provided in the Technical settings in the Merchant's personal account. If the Project fails to provide such URL, then User and Order IDs are not verified.

If the payment data are correct the System redirects the user to the Payment System site indicated in the Project information. The payment form is filled in with the data received from the Project.

When the user settles the invoice, he/she is automatically redirected to the payment result page at the System or Project site (specified in the Technical settings in the Merchant's personal account).

Minimal external form example

<form action="https://www.onlinedengi.ru/wmpaycheck.php" method="post"> 
<input type="hidden" name="project" value="..."> 
<input type="hidden" name="order_id" value="..."> 
<input type="hidden" name="paymentCurrency" value="..."> 
Your nickname: <input type="text" name="nickname" value="..."> 
Amount due in the Payment System currency: <input type="text" name="amount" value="..."> 
Payment mode: <select name="mode_type"> 
option value="1001">WebMoney WMZ</option> 
option value="1002">WebMoney WMR</option> ... </select>
<input type="submit" value="Pay!"> 
</form>