Overview
Programming interface allows to exchange information between seller and server of sales registration of MyLivePage social net.
Key definitions:
Seller
Seller is advertiser of MyLivePage social net who registers his Internet shop in affiliate program.
Affiliate program
Affiliate program is a kind of business co-operation between advertiser and MyLivePage social net in which MyLivePage social net receives an interest income for the sales in Internet shop did by visitor who comes in Internet shop from one of MyLivepae social net site.
Internet shop
Internet shop is site where consumers go through to purchase products or services over the Internet.
Server of sales registration
Server of sales registration is site owned by MyLivePage social net on which operations carried out in the partners' internet shops are registered and processed.
Site owner
Site owner is user registered in MyLivePage social net.
Reference to partner's Internet shop located on pages of site owner’s contains an identifier of this owner. This is example of reference to Internet shop:
http://internet-shop.ru/?mlp_user=NNNN
,where NNNN is an identifier of site owner (integer number).
Internet shop has to save the receiving identifier of site owner for the future request for purchase. Methods of saving can be chosen by partner. You can choose from the following list:
- to save the identifier in database in user profile
- to save in cookies of users' browsers
Mandatory requirement: life time have to be no less than 1 year if you save the identifier in browser's cookies!
Note: If user goes to Internet shop again from other site in MyLivePage social net we recommend to refresh the identifier of site owner in cookies or in database but is not mandatory requirement.
Internet shop has to generate reference of special format and send the request to server of sales registration with help of this reference to carry out the transaction.
Keeping up operations:
B. Cancellation of sale registered before
C. The request of processing effect of transaction carried out before
A. "Registration of sales" operation
"Registration of sale" operation consists of 2 stages: the initiate request from Internet shop to server of sales registration and the confirming request from server of sale to Internet shop.
| Name of parameters | Value |
|---|---|
| action | String
Value for this operation is "Sell". |
| id | Integer number
Ordinal number of Internet shop read-out after its registration in affiliate program. You can find out this number in "Partnership with MLP NV" panel (http://partners.mylivepage.net/) |
| mlp_user | Integer number
Ordinal number of site owner in MyLivePage social net from which visitor makes purchase in Internet shop. |
| sum | Floating-point number
Sum total in USA dollar. Integer part has to be separated from fractional part with point. |
| orderid | Integer number
Operation number. It should not repeat. |
Illustration: Proram number for adding in "id" field
Internet shop has to send a request with these parameters using http protocol and GET and POST methods to the following address:
http://partners.mylivepage.net/affiliate_click
For example:
| Text answer | Meaning of answer |
|---|---|
| CREATE ORDER
PROCESSED SUCCESSFULLY | The request is successfully processed |
| CREATE ORDER
ALLREADY PROCESSED | The request with these parameters have already been processed before repeated processing is impossible |
| CREATE ORDER
NOT CONFIRMED | The request isn't processed by reason that Internet shop doesn't response to the confirming request or the answer format is incorrect. It is necessary to find out whether Internet shop responses on the confirming requests or correct format of the answer. |
| CREATE ORDER
NOT PROCESSED | The request isn't processed by other reasons. It is necessary to repeat the request with the same parameters later. |
| CREATE ORDER
INCORRECT PARAMETER : fields' list | The request isn't processed by reason of incorrect parameters points. The parameters pointed in incorrect format will be listed in the list of fields. It need to correct the parameters and repeat the request. |
Receiving this request the server of sales registration carry out the request to confirmation of sale operation using http protocol and GET method.
2. The format of request to confirmation of " Registration of Sale" operation.
The request will be sent to site of Internet shop registered in affiliate program.
| Name of parameter | Value |
|---|---|
| mlp_user | String
|
| orderid | Integer number
|
For example, if partner points site address of his Internet shop http://internet-shop.ru the request to confirmation looks like http://internet-shop.ru/?mlp_user=check&orderid=3
Registration server waits for answer in text form in which parametres points that were in the request with "line feed" separator were listed.
| Name of parametr | Value |
|---|---|
| id | Ordinal number of Internet shop read-out after its registration in partner's program. |
| mlp_user | Ordinal number of site owner in MylivePage social net from which the visitor did the purchase in Internet shop comes |
| sum | Sum total in USA dollar. Integer part has to be separated from fractional part with point. |
| orderid | Operation number |
Example:
1. If Internet shop send the following request
2. Server of sales registration will send the following request
3. Internet shop has to response the following text message:
B. Cancellation of sale registered before
You can ccancel the sale that have been done earlier in case commision have already been paid by partner.
This feature is not implemented fully.
C. The request of processing effect of transaction carried out before
You can find out the result of operation carried out before. Б. Отмена продажи, зарегистрированной ранее
Можно отменить ранее совершённую продажу, даже комиссия уже выплачена партнёром. Операция полностью не реализована. В. Запрос результата обработки ранее обработанной операции
Можно узнать результат ранее обработанной операции.