Script Notification for Prepayment of the Invoice, for Its Paying Off, and for Refund (Moneyback)

Paying Off Notification

You can activate the system notification for when a customer pays for the order.

To do this, enter your script address into the “URL for API notifications about the paid invoice” field when editing the product. Our service will send notifications there.

Notifications are sent to this address after the order has been paid. When it is created, notifications are sent to the address indicated in the “URL for API notifications about the created invoice” field (more info).

You can enter the same script in both fields. But at the same time, add a parameter specifying what notification is this.

For example, like this:

• the “URL for API notifications about the created invoice” field: https://mysite.io/script?a=make
• the “URL for API notifications about the paid invoice” field: https://mysite.io/script?a=paid

Or determine the made order by the absence in the received data of the value with the [‘paid’] key.

Notifications are sent in the URL-encoded POST format as follows:

array(
'id' => order number
'first_name' => customer’s name
'last_name' => customer’s last name
'middle_name' => customer’s middle name
'email' => customer’s email
'phone' => customer’s telephone number
'city' => the city of the delivery
'country' => the country of the delivery
'address' => address of the delivery
'region' => region of the delivery
'postalcode' => postal code
'created' => the order creation time
'paid' => the order paying-off time
'last_payment_sum' => amount of the last payment (if the bill is paid in one payment, then it is equal to the amount of the bill)
'comment' => comment on the order
'tag' => tag
'kupon' => used coupon
'type' => type
'payway' => method of payment
'domain' => order domain
'is_recurrent' => Is the bill recurrent? (1 - yes, 0 - no),
'utm' => array (
   'medium' => channel utm-parameter
   'source' => source utm-parameter
   'campaign' => campaign utm-parameter
   'content' => advertisement utm-parameter
   'term' => key utm-parameter
   ),
'items' => array( goods array
array(
'id' => character identifier
'title' => product name
'sum' => actual product cost (including up-selling or discount)
'price' => product price from settings
'pincode' => pin-code sent in the letter after the payment
'partners' => array (
   0 => array (
       'partner_lvl' => affiliate level (the first level)
       'partner_id' => partner’s identifier
       'partner_name' => partner’s login
       'partner_fee' => the amount of partner’s charges
       ),
   1 => array (
       'partner_lvl' => affiliate level (the second level)
       'partner_id' => partner’s identifier
       'partner_name' => partner’s login
       'partner_fee' =>  the amount of partner’s charges
       ),
   ),
),
array(
'id' => character identifier
'title' => product name
'sum' => actual product cost (including up-selling or discount)
'price' => product price from settings
'pincode' => pin-code sent in the letter after the payment
'partners' => array (
   0 => array (
       'partner_lvl' => affiliate level (the first level)
       'partner_id' => partner’s identifier
       'partner_name' => partner’s login
       'partner_fee' => the amount of partner’s charges
       ),
   1 => array (
       'partner_lvl' => affiliate level (the second level)
       'partner_id' => partner’s identifier
       'partner_name' => partner’s login
       'partner_fee' =>  the amount of partner’s charges
       ),
   ),
),
...
)
'hash' => md5 (order number + customer’s mail + time of paying-off the order + secret key)
)

Example in PHP:

$hash = md5($_REQUEST['id'].$_REQUEST['email'].$_REQUEST['paid'].$setts['user_rps_key']);

Where, the “secret key” for forming a hash is a line that can be found in the “API” section (right-side of the JustClick personal cabinet) ⇒  “API key”.

Where, the “secret key” for forming a hash is a line that can be found in the “API” section (right-side of the JustClick personal cabinet) ⇒ “API key”.

For example, if you use PHP for development, the transferred data immediately goes into the $ _query system array.

$ _query[‘items’][0][‘sum’] will be equal to the cost of the first item in the order.

Prepayment Notification

You can activate the system notification for when a customer pays for the order in advance.

To do this, enter your script address into the “URL for API notifications about the pre-paid invoice” field when editing the product. Our service will send notifications there.

Notifications are sent in the URL-encoded POST format as follows:

array(

'id' => order number
'first_name' => customer’s name
'last_name' => customer’s last name
'middle_name' => customer’s middle name
'email' => customer’s email
'phone' => customer’s telephone number
'city' => the city of the delivery
'country' => the country of the delivery
'region' => region of the delivery
'postalcode' => postal code
'created' => the order creation time
'prepayment_sum' => prepayment sum
'tag' => tag
'kupon' => used coupon
'domain' => order domain
'link' => link to the order payment page
'is_recurrent' => Is the bill recurrent? (1 - yes, 0 - no),
'utm' => array (
   'medium' => channel utm-parameter
   'source' => source utm-parameter
   'campaign' => campaign utm-parameter
   'content' => advertisement utm-parameter
   'term' => key utm-parameter
   ),
'items' => array( goods array
array(
'id' => character identifier
'title' => product name
'sum' => actual product cost (including up-selling or discount)
'price' => product price from settings
'pincode' => pin-code sent in the letter after the payment
'partners' => array (
   0 => array (
       'partner_lvl' => affiliate level (the first level)
       'partner_id' => partner’s identifier
       'partner_name' => partner’s login
       'partner_fee' => the amount of partner’s charges
       ),
   1 => array (
       'partner_lvl' => affiliate level (the second level)
       'partner_id' => partner’s identifier
       'partner_name' => partner’s login
       'partner_fee' =>  the amount of partner’s charges
              ),
   ),
),
...
)
'hash' => md5 (order number + customer’s mail + time of paying-off the order + secret key)
)

MoneyBack Notification

You can activate the system notification for when a customer wants full refund.

Enter your script address into the “URL for API notifications about the MoneyBack” field. Notifications are sent in the URL-encoded POST format as follows:

array(

'status' => 'moneyback'
'id' => order number
'first_name' => customer’s name
'last_name' => customer’s last name
'middle_name' => customer’s middle name
'email' => customer’s email
'phone' => customer’s telephone number
'city' => the city of the delivery
'country' => the country of the delivery
'region' => region of the delivery
'postalcode' => postal code
'created' => the order creation time
'comment' => comment on the order
'is_recurrent' => Is the bill recurrent? (1 - yes, 0 - no),
'utm' => array (
   'medium' => channel utm-parameter
   'source' => source utm-parameter
   'campaign' => campaign utm-parameter
   'content' => advertisement utm-parameter
   'term' => key utm-parameter
   ),
'items' => array( goods array
array(
'id' => character identifier
'title' => product name
'sum' => actual product cost (including up-selling or discount)
'price' => product price from settings
       ),
   ),
array(
'id' => character identifier
'title' => product name
'sum' => actual product cost (including up-selling or discount)
'price' => product price from settings
),
...
)
'hash' => md5 (order number + customer’s mail + time of paying-off the order + secret key)
)