Use WebMoney
Overview
Place an order with catalog products defined in your Merchant Control Panel and collect the payment using WebMoney.
Requirements
Shoppers in the CIS (Commonwealth of Independent States) area, Russia, and Asia (Malaysia, Indonesia) can purchase using WebMoney.
Supported currencies
WebMoney supports transactions in EUR.
Workflow
- If the shopper is paying with any one of the supported currencies, they can use WebMoney as a payment method in the shopping cart.
- After the order is generated by calling the placeOrder method, in the order's details the shopper will find a URL where they need to be redirected in order to finish the payment.
- The URL can be found in the PaymentDetails/PaymentMethod response object, under the Redirect attribute. The shopper needs to be redirected to that URL via a POST call, with the parameters available in the API response sent to the URL.
- Once the shopper finishes the payment process on the WebMoney side, the order will be updated in the 2Checkout system as well.
Parameters
Parameters | Type/Description |
---|---|
sessionID |
Required (string) |
|
Session identifier, the output of the Login method. Include sessionID into all your requests. 2Checkout throws an exception if the values are incorrect. The sessionID expires in 10 minutes. |
Required (Object) |
|
|
Object designed to collect all data necessary for an order, including billing, product/subscription plan and payment details. See code sample for more details. |
Request Example
<?php
require ('PATH_TO_AUTH');
$Order = new stdClass();
$Order->RefNo = NULL;
$Order->Currency = 'EUR';
$Order->Country = "RO";
$Order->Language = 'EN';
$Order->CustomerIP = '10.5.22.197';
$Order->ExternalReference = NULL;
$Order->Source = NULL;
$Order->Affiliate = new stdClass();
$Order->Affiliate->AffiliateCode = 'Partner123'
$Order->Affiliate->AffiliateSource = 'MobilePlatform'
$Order->CustomerReference = NULL;
$Order->Items = array();
$Order->Items[0] = new stdClass();
$Order->Items[0]->Code = 'a01';
$Order->Items[0]->Quantity = 1;
$Order->Items[0]->PriceOptions = NULL;
$Order->Items[0]->SKU = NULL;
$Order->Items[0]->Price = NULL;
$Order->Items[0]->CrossSell = NULL;
$Order->Items[0]->Trial = false;
$Order->Items[0]->AdditionalFields = NULL;
$Order->Items[0]->SubscriptionStartDate = NULL;
$Order->BillingDetails = new stdClass();
$Order->BillingDetails->FirstName = 'John';
$Order->BillingDetails->LastName = 'Doe';
$Order->BillingDetails->CountryCode = "RO";
$Order->BillingDetails->State = 'Bucharest';
$Order->BillingDetails->City = 'Bucharest';
$Order->BillingDetails->Address1 = 'Street Name 555';
$Order->BillingDetails->Address2 = NULL;
$Order->BillingDetails->Zip = '1111111';
$Order->BillingDetails->Email = 'test@2checkout.com';
$Order->BillingDetails->Phone = '00402505555';
$Order->BillingDetails->Company = 'blank';
$Order->DeliveryDetails = new stdClass();
$Order->DeliveryDetails->FirstName = 'John';
$Order->DeliveryDetails->LastName = 'Doe';
$Order->DeliveryDetails->CountryCode = 'NZ';
$Order->DeliveryDetails->State = 'Bucharest';
$Order->DeliveryDetails->City = 'Bucharest';
$Order->DeliveryDetails->Address1 = 'Street Name 555';
$Order->DeliveryDetails->Address2 = NULL;
$Order->DeliveryDetails->Zip = '1111111';
$Order->DeliveryDetails->Email = 'test@2checkout.com';
$Order->DeliveryDetails->Phone = '00402505555';
$Order->DeliveryDetails->Company = NULL;
$Order->PaymentDetails = new stdClass ();
$Order->PaymentDetails->Type = 'WEBMONEY';
$Order->PaymentDetails->Currency = 'EUR';
$Order->PaymentDetails->HadPayPalToken = false;
$Order->PaymentDetails->CustomerIP = '10.5.22.197';
$Order->PaymentDetails->PaymentMethod = new stdClass ();
$Order->PaymentDetails->PaymentMethod->ReturnURL = 'https://yourreturnurl.com';
$Order->PaymentDetails->PaymentMethod->CancelURL= 'https://yourcancelurl.com ';
$Order->Promotions = NULL;
$Order->AdditionalFields = NULL;
$Order->LocalTime = NULL;
$Order->GiftDetails = NULL;
try {
$newOrder = $client->placeOrder($sessionID, $Order);
var_dump($newOrder);
}
catch (SoapFault $e) {
echo "newOrder: " . $e->getMessage();
exit;
}
?>
Response Parameters
Parameter | Type/Description |
---|---|
Object |
|
Object containing order information. |
Response Example
{
"RefNo": "189878812",
"OrderNo": 0,
"ExternalReference": null,
"ShopperRefNo": null,
"Status": "PENDING",
"ApproveStatus": "WAITING",
"VendorApproveStatus": "OK",
"MerchantCode": "251772850506",
"Language": "en",
"OrderDate": "2022-08-23 14:52:20",
"FinishDate": null,
"Source": "testAPI.com",
"WSOrder": null,
"Affiliate": {
"AffiliateCode": null,
"AffiliateSource": null,
"AffiliateName": null,
"AffiliateUrl": null
},
"HasShipping": true,
"BillingDetails": {
"FiscalCode": null,
"TaxOffice": null,
"Phone": "010-6552-9988",
"FirstName": "John",
"LastName": "Doe",
"Company": null,
"Email": "test@verifone.com",
"Address1": "Test Address",
"Address2": null,
"City": "Test City",
"Zip": "35005",
"CountryCode": "de",
"State": null
},
"DeliveryDetails": {
"Phone": "010-6552-9988",
"FirstName": "John",
"LastName": "Doe",
"Company": null,
"Email": "test@verifone.com",
"Address1": "Test Address",
"Address2": null,
"City": "Test City",
"Zip": "35005",
"CountryCode": "de",
"State": null
},
"PaymentDetails": {
"Type": "WEBMONEY",
"Currency": "eur",
"PaymentMethod": {
"Amount": "35.5",
"Currency": "eur",
"Redirect": {
"Url": "https://psp.paymaster24.com/Payment/Init",
"Method": "POST",
"Params": {
"LMI_MERCHANT_ID": "094c1995-1c81-4779-bf14-79e0127a0aed",
"LMI_PAYMENT_AMOUNT": "35.5",
"LMI_PAYMENT_NO": "189878812",
"LMI_PAYMENT_DESC": "Payment for Avangate: #189878812",
"LMI_SIM_MODE": "",
"LMI_CURRENCY": "EUR",
"LMI_SUCCESS_URL": "https://yourreturnurl.com",
"LMI_FAILURE_URL": "https://yourreturnurl.com"
},
"FullHtml": "<!DOCTYPE html><html><body><form action=\"https://psp.paymaster24.com/Payment/Init\" method=\"POST\" id=\"postform\"><input type=\"hidden\" name=\"LMI_MERCHANT_ID\" value=\"094c1995-1c81-4779-bf14-79e0127a0aed\" /><input type=\"hidden\" name=\"LMI_PAYMENT_AMOUNT\" value=\"35.5\" /><input type=\"hidden\" name=\"LMI_PAYMENT_NO\" value=\"189878812\" /><input type=\"hidden\" name=\"LMI_PAYMENT_DESC\" value=\"Payment for Avangate: #189878812\" /><input type=\"hidden\" name=\"LMI_SIM_MODE\" value=\"\" /><input type=\"hidden\" name=\"LMI_CURRENCY\" value=\"EUR\" /><input type=\"hidden\" name=\"LMI_SUCCESS_URL\" value=\"https://api.2checkout.com/order/gateway_return.php\" /><input type=\"hidden\" name=\"LMI_FAILURE_URL\" value=\"https://api.2checkout.com/order/gateway_cancel.php\" /></form><script type=\"text/javascript\">document.getElementById(\"postform\").submit();</script></body></html>"
},
"ReturnURL":https://yourreturnurl.com,
"CancelURL": https://yourcancelurl.com,
"Vendor3DSReturnURL": null,
"Vendor3DSCancelURL": null,
"InstallmentsNumber": null
},
"CustomerIP": "91.220.121.21"
},
"DeliveryInformation": {
"ShippingMethod": {
"Code": null,
"TrackingUrl": null,
"TrackingNumber": null,
"Comment": null
}
},
"CustomerDetails": null,
"Origin": "API",
"AvangateCommission": 2.63,
"OrderFlow": "REGULAR",
"GiftDetails": null,
"PODetails": null,
"ExtraInformation": null,
"PartnerCode": null,
"PartnerMargin": null,
"PartnerMarginPercent": null,
"ExtraMargin": null,
"ExtraMarginPercent": null,
"ExtraDiscount": null,
"ExtraDiscountPercent": null,
"LocalTime": null,
"TestOrder": false,
"FxRate": 0.960096,
"FxMarkup": 4,
"PayoutCurrency": "USD",
"DeliveryFinalized": false,
"Errors": null,
"Items": [
{
"ProductDetails": {
"Name": "Test Product",
"ShortDescription": "<p>Join all your clouds in a big one</p>",
"Tangible": false,
"IsDynamic": false,
"ExtraInfo": null,
"RenewalStatus": false,
"Subscriptions": null,
"DeliveryInformation": {
"Delivery": "BY_AVANGATE",
"DownloadFile": null,
"DeliveryDescription": "",
"CodesDescription": "",
"Codes": []
}
},
"PriceOptions": [],
"Price": {
"UnitNetPrice": 29.83,
"UnitGrossPrice": 35.5,
"UnitVAT": 5.67,
"UnitDiscount": 0,
"UnitNetDiscountedPrice": 29.83,
"UnitGrossDiscountedPrice": 35.5,
"UnitAffiliateCommission": 0,
"ItemUnitNetPrice": null,
"ItemUnitGrossPrice": null,
"ItemNetPrice": null,
"ItemGrossPrice": null,
"VATPercent": 19,
"HandlingFeeNetPrice": 0,
"HandlingFeeGrossPrice": 0,
"Currency": "eur",
"NetPrice": 29.83,
"GrossPrice": 35.5,
"NetDiscountedPrice": 29.83,
"GrossDiscountedPrice": 35.5,
"Discount": 0,
"VAT": 5.67,
"AffiliateCommission": 0
},
"LineItemReference": "0b136a51c517ae2bcba2af651a97f925f1589e98",
"PurchaseType": "PRODUCT",
"Code": "LPUJL13OZ6",
"ExternalReference": "",
"Quantity": 1,
"SKU": null,
"CrossSell": null,
"Trial": null,
"AdditionalFields": null,
"Promotion": null,
"RecurringOptions": null,
"SubscriptionStartDate": null,
"SubscriptionCustomSettings": null,
"UpSell": null
}
],
"Promotions": [],
"AdditionalFields": null,
"Currency": "eur",
"NetPrice": 29.83,
"GrossPrice": 35.5,
"NetDiscountedPrice": 29.83,
"GrossDiscountedPrice": 35.5,
"Discount": 0,
"VAT": 5.67,
"AffiliateCommission": 0,
"CustomParameters": null,
"Refunds": null
}
For more on how to redirect shoppers to the payment method’ page to finalize the payment, read here.