- Payment settings description
Setting the reception of the payment is executed on the setup page for each site separately. Form settings are available by clicking  on the sites management page or when adding the new site.
Settings form contains the following configuration options:
Option |
Required |
Description |
|
Site name | Yes | Your site name is displayed to customers in the implementation of the payment.
| | Result URL | No | URL-address of the page, to which will be sent the successful payment implementation notice. The form is sent without using customers web browser by POST method. URL must begin with http:// or https://. If the Result URL is not specified, the notice of payment will be sent to the E-Mail. Result URL or E-Mail is required settings.
| | Success URL | Yes | URL-address of the site, to which will be sent a successful payment implementation form. The form is sent by Success URL Method using visitor/s web-browser. Must start with http:// or https://
| | Success URL Method | Yes | The method used to submit the successful payment implementation. Can be GET or POST.
| | Middle URL | Yes | URL-address of the site, on which visitor will be sent in the case of semi-automatic payment method selection. The form is sent by Middle URL Method using visitor's web-browser (the form is similar to successful payment implementation form). Must start with http:// or https://.
| | Middle URL Method | Yes | The method used to submit the form of payment implementation by semi-automatic mode (the form is similar to successful payment implementation form). Can be GET or POST.
| | Fail URL | Yes | URL-address of the site, to which will be sent Unsuccessful outcome payment form. The form is sent by Fail URL Method using visitor's web browser. Must start with http:// or https://.
| | Fail URL Method | Yes | The method used to submit the Unsuccessful outcome payment form. Can be GET or POST.
| | E-Mail | No | E-Mail, which will be sent the successful payment implementation notification. If not been set, payement notice will be sent only to Result URL. Result URL or E-Mail is required settings, otherwise you will not get payment notification.
| | Allow URL changing | No | Allow using Success URL, Middle URL and Fail URL, transmitted in payment request form.
| | Site is enabled | No | Check to enable acception of funds for this site.
| | External p/s payments | No | Check to enable reception of funds from external payment systems (otherwise, only internal JetSwap payments will be accepted). In addition to setting this option, you should make a pledge to use the acception of funds from external payment systems feature. |
JetSwap Merchant Service operates as follows:
- The seller creates Payment Request Form on his/her site, which is sending by buyer to JetSwap Merchant site by POST method.
- The buyer chooses the most appropriate method of payment and redirecteing to the selected payment system page for payement processing.
- During the buyer payment process, JetSwap Merchant site, recieves a notice of successful payment from the selected payment system, after which JetSwap Merchant site sends apayment notification to the Result URL.
- If buyer chose non-automatic payment method (such as by wire transfer), then buyer sends to the Middle URL. After operator will process the payment, buyer receives an e-mail with the link to continue the operation. After clicking on the link buyer get to Success URL.
- After the payment, buyer returns to JetSwap Merchant site, from which passes to the seller site by SuccessURL.
- If the error occured during the payment process, or buyer refused to make a payment, he/she returns to the seller site by Fail URL.
- HTML-forms using for making payments
The Implementation of connection seller's site with JetSwap Merchant Service is accomplished by sending HTML-forms.
Sending by buyer to the seller's website to start the receiving payment process.
Form must contain the following options:
Action: http://go.jetswap.net/payment
Method: POST
Fields, sending in form:
Option |
Required |
Description |
| PAY_SITE | Yes | Seller's site ID. Can be get on the Site management page, or by clicking  picture.
| | PAY_CR | No/If PAY_WM | Specifies the amount of payment by JetSwap points. If not specified, payment wiht JetSwap points is impossible. At least one of the parameters PAY_CR or PAY_WM must be submited.
| | PAY_WM | No/If PAY_CR | Specifies the amount of payment in standard units (U.S. dollars). If not specified, payment in equivalent units (U.S. dollars) is impossible. Converted by the current funds deposit rate to JetSwap Service. At least one of the parameters PAY_CR or PAY_WM must be submited.
| | PAY_ORDER | No | Unique account number in the seller's accounting system. Must be an integer.
| | PAY_DESC | No | Description of purchase. Can not have more than 250 characters.
| | PAY_NAME | No | Name of the buyer. If not specified, will be consulted in payment process by JetSwap Merchant service.
| | PAY_EMAIL | No | Buyer's E-Mail. If not specified, will be consulted in payment process by JetSwap Merchant service.
| | PAY_SUCCESS | No | Replaces Success URL, if allowed in the website settings.
| | PAY_SUCCESSMETHOD | No | Replaces Success URL Metod, if allowed in the website settings.
| | PAY_FAIL | No | Replaces Fail URL, if allowed in the website settings.
| | PAY_FAILMETHOD | No | Replaces Fail URL Method, if allowed in the website settings.
| | PAY_MIDDLE | No | Replaces Middle URL, if allowed in the website settings.
| | PAY_MIDDLEMETHOD | No | Replaces Middle URL Method, if allowed in the website settings.
| | Any parameters that have no PAY_ prefix | No | The number and format of the parameters is defined by seller. The total amount of user-defined information must not exceed 10000 bytes.
|
Payment request form example:
<form action=http://go.jetswap.net/payment method=post>
<input name=PAY_SITE value=111 type=hidden>
<input name=PAY_CR value=1000 type=hidden>
<input name=PAY_WM value=1 type=hidden>
<input name=PAY_DESC value='Payment Description' type=hidden>
<input name=PAY_ORDER value='222' type=hidden>
<input name=somefield value=somevalue type=hidden>
<input name=anotherfield value=anothervalue type=hidden>
</form>
- Payment notification form
Sending in the case of successful payment to seller's Result URL and/or E-Mail. Has the following options:
Action: Result URL èëè E-Mail
Method: POST
Fields, sending in form:
Option |
Description |
| PAY_SITE | Seller's site ID.
| | PAY_CR | The amount of payment in points â (if payement was made in ponts).
| | PAY_WM | The amount of payment in equivalent units (U.S. dollars) (if payment was made in any e-currency)
| | PAY_ID | Internal bill number, written out by JetSwap Merchant service.
| | PAY_ORDER | Bill number in seller's payments accounting system.
| | PAY_NAME | Buyer's name, entered by buyer on the site, or transferred in payment request form by seller.
| | PAY_EMAIL | Buyer's E-Mail, entered by buyer on the site, or transferred in payment request form by seller.
| | PAY_DESC | Payement description transmitted by seller to JetSwap Merchant service.
| | PAY_TIME | Payment time in UNIX_TIMESTAMP format
| | PAY_METHOD | Buyer's chosen payment method. Can be:
- 0 - JetSwap points
- 1 - Internal funds transfer via JetSwap service
- 2 - Funds transfer via WebMoney
- 3 - Funds transfer via E-Gold
- 4 - Funds transfer via RBK Money(RUPAY) (includes all payment methods offered by RUPAY service)
- 5 - Funds transfer via LibertyReserve.
- 6 - Fuinds transfer via WebMoney loans
| | PAY_PURSE | Buyer's details, wich were used to pay the bill.
| | PAY_CODE | Hash code, confirming that the form submission is accomplished JetSwap Merchant service. More.
| | Any parameters that have no PAY_ prefix | The number and options format is defined by the seller. These parameters were transferred to seller's web site while Payment request form sending.
|
If E-Mail field is specified in preferences, then similar form is sending to E-Mail
Payment notification form example:
<form action=http://www.merchant_site.ru/resulturl.php method=post>
<input name=PAY_SITE value=111 type=hidden>
<input name=PAY_CR value=0 type=hidden>
<input name=PAY_WM value=5 type=hidden>
<input name=PAY_DESC value='Payment Description' type=hidden>
<input name=PAY_ORDER value='222' type=hidden>
<input name=PAY_ID value='1111' type=hidden>
<input name=PAY_TIME value='1129373557' type=hidden>
<input name=PAY_MERHOD value='1' type=hidden>
<input name=PAY_PURSE value='jetswapuserlogin' type=hidden>
<input name=PAY_NAME value='Vasya' type=hidden>
<input name=PAY_EMAIL value='vasya@vasya.ru' type=hidden>
<input name=PAY_CODE value='11b29cbd3c73s52d313ade147effa557' type=hidden>
<input name=somefield value=somevalue type=hidden>
<input name=anotherfield value=anothervalue type=hidden>
</form>
- Successful payment implementation form
The form is sending in case of successful payment completion by buyer's web-browser, to seller's Success URL.
Action: Success URL
Method: Success URL Method
Fields, sending in form:
Option |
Description |
| PAY_ID | Bill number, invoiced buyer for payment by JetSwap Merchant service.
| | PAY_ORDER | Bill number, invoiced buyer for payment by the seller.
| | PAY_METHOD | Customer defined payment method.
| | Any parameters that have no PAY_ prefix | The number and options format is defined by the seller. These parameters were transferred to seller's web site while Payment request form sending.
|
Successful payment implementation form example:
<form action="Success URL" method="Success URL Method">
<input type=hidden name=PAY_ID value='34623'>
<input type=hidden name=PAY_ORDER value='343'>
<input type=hidden name=PAY_METHOD value='3'>
...
<input type=hidden name=somename value=somevalue>
...
</form>
- Unsuccessful payment outcome form
Sending by buyer's web-browser when an error occurs in one of the payment steps or in case of the buyer's payment refusal. The form has the following options:
Action: Fail URL
Method: Fail URL Method
Fields, sending in form:
Option |
Description |
| PAY_ID | Bill number, invoiced buyer for payment by JetSwap Merchant service.
| | PAY_ORDER | Bill number, invoiced buyer for payment by the seller.
| | Any parameters that have no PAY_ prefix | The number and options format is defined by the seller. These parameters were transferred to seller's web site while Payment request form sending.
|
Unsuccessful payment outcome form example:
<form action="Fail URL" method="Fail URL Method">
<input type=hidden name=PAY_ID value='34623'>
<input type=hidden name=PAY_ORDER value='343'>
...
<input type=hidden name=somename value=somevalue>
...
</form>
- Payment data verification
An important step of automatic funds acception is Payment data verification before granting the buyer of goods and services. You should check:
- Payment amount - buyer could change it before sending the payment request form.
- Verification Signature - variable PAY_CODE, transmitted to Result URL. PAY_CODE=md5("PAYMENT::PAY_SITE::SECRET_KEY::PAY_CR::PAY_WM::PAY_ID::PAY_ORDER::PAY_TIME::PAY_NAME::PAY_EMAIL::PAY_DESC::PAY_METHOD::PAY_PURSE")
- Site ID - check the compliance of your site ID with PAY_ID, transmitted in form.
Example of verification of these parameters in PHP you can get by clicking on the link on Sites management page.
You should test the service until you are sure that your site works correctly! Unfortunately, the possibility of testing the service is not provided by standard means, but you can make internal payments to your account with your account. Thus, the costs will be minimized and will only contain of JetSwap service commission for transaction. Transaction can be performed from 1 credit.
|
