payneteasy-payneteasyapi 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README.md +6 -6
- data/doc/00-basic-tutorial.md +150 -154
- data/doc/01-library-internals.md +4 -4
- data/doc/library-internals/00-payment-data.md +62 -60
- data/doc/library-internals/01-payment-processor.md +87 -85
- data/doc/library-internals/02-validator.md +37 -38
- data/doc/library-internals/03-property-accessor.md +58 -46
- data/doc/payment-scenarios/00-sale-transactions.md +33 -33
- data/doc/payment-scenarios/01-preauth-capture-transactions.md +36 -36
- data/doc/payment-scenarios/02-transfer-transactions.md +22 -23
- data/doc/payment-scenarios/03-return-transactions.md +9 -9
- data/doc/payment-scenarios/04-recurrent-transactions.md +36 -37
- data/doc/payment-scenarios/05-payment-form-integration.md +19 -19
- data/doc/payment-scenarios/06-merchant-callbacks.md +8 -8
- data/example/capture.rb +38 -1
- data/example/common/functions.rb +40 -6
- data/lib/paynet_easy/paynet_easy_api/util/validator.rb +1 -1
- data/payneteasy-payneteasyapi.gemspec +6 -4
- metadata +4 -20
|
@@ -7,52 +7,52 @@
|
|
|
7
7
|
## Общие положения
|
|
8
8
|
|
|
9
9
|
* В данной статье описывается исключительно работа с библиотекой. Полная информация о выполнении Sale transactions расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Sale_Transactions).
|
|
10
|
-
* Описание правил валидации можно найти в описании метода **[Validator
|
|
10
|
+
* Описание правил валидации можно найти в описании метода **[Validator.validate_by_rule()](../library-internals/02-validator.md#validate_by_rule)**.
|
|
11
11
|
* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
|
|
12
12
|
|
|
13
13
|
## <a name="sale"></a> Запрос "sale"
|
|
14
14
|
|
|
15
15
|
Запрос применяется для оплаты с помощью кредитной карты. При этом информация о карте вводится на стороне сервиса мерчанта и передается в запросе к PaynetEasy. После выполнения данного запроса необходимо выполнить серию запросов "**status**" для обновления статуса платежа. Для этого сервис мерчанта может вывести самообновляющуюся страницу, каждая перезагрузка которой будет выполнять запрос "**status**".
|
|
16
16
|
|
|
17
|
-
[Пример самообновляющейся страницы](../../example/common/
|
|
17
|
+
[Пример самообновляющейся страницы](../../example/common/wait_page.erb)
|
|
18
18
|
|
|
19
19
|
##### Обязательные параметры запроса
|
|
20
20
|
|
|
21
|
-
Поле запроса |Цепочка свойств платежа
|
|
22
|
-
|
|
23
|
-
client_orderid |payment.
|
|
24
|
-
order_desc |payment.description
|
|
25
|
-
amount |payment.amount
|
|
26
|
-
currency |payment.currency
|
|
27
|
-
address1 |payment.
|
|
28
|
-
city |payment.
|
|
29
|
-
zip_code |payment.
|
|
30
|
-
country |payment.
|
|
31
|
-
phone |payment.
|
|
32
|
-
ipaddress |payment.customer.
|
|
33
|
-
email |payment.customer.email
|
|
34
|
-
card_printed_name |payment.
|
|
35
|
-
credit_card_number |payment.
|
|
36
|
-
expire_month |payment.
|
|
37
|
-
expire_year |payment.
|
|
38
|
-
cvv2 |payment.
|
|
39
|
-
redirect_url |
|
|
21
|
+
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
22
|
+
--------------------|---------------------------------------|-----------------
|
|
23
|
+
client_orderid |payment.client_id |Validator::ID
|
|
24
|
+
order_desc |payment.description |Validator::LONG_STRING
|
|
25
|
+
amount |payment.amount |Validator::AMOUNT
|
|
26
|
+
currency |payment.currency |Validator::CURRENCY
|
|
27
|
+
address1 |payment.billing_address.first_line |Validator::MEDIUM_STRING
|
|
28
|
+
city |payment.billing_address.city |Validator::MEDIUM_STRING
|
|
29
|
+
zip_code |payment.billing_address.zip_code |Validator::ZIP_CODE
|
|
30
|
+
country |payment.billing_address.country |Validator::COUNTRY
|
|
31
|
+
phone |payment.billing_address.phone |Validator::PHONE
|
|
32
|
+
ipaddress |payment.customer.ip_address |Validator::IP
|
|
33
|
+
email |payment.customer.email |Validator::EMAIL
|
|
34
|
+
card_printed_name |payment.credit_card.card_printed_name |Validator::LONG_STRING
|
|
35
|
+
credit_card_number |payment.credit_card.credit_card_number |Validator::CREDIT_CARD_NUMBER
|
|
36
|
+
expire_month |payment.credit_card.expire_month |Validator::MONTH
|
|
37
|
+
expire_year |payment.credit_card.expire_year |Validator::YEAR
|
|
38
|
+
cvv2 |payment.credit_card.cvv2 |Validator::CVV2
|
|
39
|
+
redirect_url |query_config.redirect_url |Validator::URL
|
|
40
40
|
|
|
41
41
|
##### Необязательные параметры запроса
|
|
42
42
|
|
|
43
43
|
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
44
44
|
--------------------|-----------------------------------|-----------------
|
|
45
|
-
first_name |payment.customer.
|
|
46
|
-
last_name |payment.customer.
|
|
45
|
+
first_name |payment.customer.first_name |Validator::MEDIUM_STRING
|
|
46
|
+
last_name |payment.customer.last_name |Validator::MEDIUM_STRING
|
|
47
47
|
ssn |payment.customer.ssn |Validator::SSN
|
|
48
48
|
birthday |payment.customer.birthday |Validator::DATE
|
|
49
|
-
state |payment.
|
|
50
|
-
cell_phone |payment.
|
|
49
|
+
state |payment.billing_address.state |Validator::COUNTRY
|
|
50
|
+
cell_phone |payment.billing_address.cell_phone |Validator::PHONE
|
|
51
51
|
destination |payment.destination |Validator::LONG_STRING
|
|
52
|
-
site_url |
|
|
53
|
-
server_callback_url |
|
|
52
|
+
site_url |query_config.site_url |Validator::URL
|
|
53
|
+
server_callback_url |query_config.callback_url |Validator::URL
|
|
54
54
|
|
|
55
|
-
[Пример выполнения запроса sale](../../example/sale.
|
|
55
|
+
[Пример выполнения запроса sale](../../example/sale.rb)
|
|
56
56
|
|
|
57
57
|
## <a name="status"></a> Запрос "status"
|
|
58
58
|
|
|
@@ -74,13 +74,13 @@ server_callback_url |queryConfig.callbackUrl |Validator::URL
|
|
|
74
74
|
|
|
75
75
|
Поле запроса |Цепочка свойств платежа|Правило валидации
|
|
76
76
|
--------------------|-----------------------|-----------------
|
|
77
|
-
client_orderid |payment.
|
|
78
|
-
orderid |payment.
|
|
79
|
-
login |
|
|
77
|
+
client_orderid |payment.client_id |Validator::ID
|
|
78
|
+
orderid |payment.paynet_id |Validator::ID
|
|
79
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
80
80
|
|
|
81
|
-
[Пример выполнения запроса status](../../example/status.
|
|
81
|
+
[Пример выполнения запроса status](../../example/status.rb)
|
|
82
82
|
|
|
83
|
-
## <a name="3d-redirect"> Обработка результата платежа после 3D-авторизации
|
|
83
|
+
## <a name="3d-redirect"></a> Обработка результата платежа после 3D-авторизации
|
|
84
84
|
|
|
85
85
|
Если при обработке платежа выполнялась 3D-авторизация, то при возвращении пользователя с формы авторизации на сервис мерчанта будут переданы данные с результатом обработки платежа. Обработка этих данных совпадает с обработкой данных для [sale-form, preauth-form или transfer-form](05-payment-form-integration.md) и описана в [базовом примере использования библиотеки](../00-basic-tutorial.md#stage_2).
|
|
86
86
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
## Общие положения
|
|
9
9
|
|
|
10
10
|
* В данной статье описывается исключительно работа с библиотекой. Полная информация о выполнении Preauth/Capture transactions расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Preauth/Capture_Transactions).
|
|
11
|
-
* Описание правил валидации можно найти в описании метода **[Validator
|
|
11
|
+
* Описание правил валидации можно найти в описании метода **[Validator.validate_by_rule()](../library-internals/02-validator.md#validate_by_rule)**.
|
|
12
12
|
* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
|
|
13
13
|
|
|
14
14
|
## <a name="preauth"></a> Запрос "preauth"
|
|
@@ -19,41 +19,41 @@
|
|
|
19
19
|
|
|
20
20
|
##### Обязательные параметры запроса
|
|
21
21
|
|
|
22
|
-
Поле запроса |Цепочка свойств платежа
|
|
23
|
-
|
|
24
|
-
client_orderid |payment.
|
|
25
|
-
order_desc |payment.description
|
|
26
|
-
amount |payment.amount
|
|
27
|
-
currency |payment.currency
|
|
28
|
-
address1 |payment.
|
|
29
|
-
city |payment.
|
|
30
|
-
zip_code |payment.
|
|
31
|
-
country |payment.
|
|
32
|
-
phone |payment.
|
|
33
|
-
ipaddress |payment.customer.
|
|
34
|
-
email |payment.customer.email
|
|
35
|
-
card_printed_name |payment.
|
|
36
|
-
credit_card_number |payment.
|
|
37
|
-
expire_month |payment.
|
|
38
|
-
expire_year |payment.
|
|
39
|
-
cvv2 |payment.
|
|
40
|
-
redirect_url |
|
|
22
|
+
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
23
|
+
--------------------|---------------------------------------|-----------------
|
|
24
|
+
client_orderid |payment.client_id |Validator::ID
|
|
25
|
+
order_desc |payment.description |Validator::LONG_STRING
|
|
26
|
+
amount |payment.amount |Validator::AMOUNT
|
|
27
|
+
currency |payment.currency |Validator::CURRENCY
|
|
28
|
+
address1 |payment.billing_address.first_line |Validator::MEDIUM_STRING
|
|
29
|
+
city |payment.billing_address.city |Validator::MEDIUM_STRING
|
|
30
|
+
zip_code |payment.billing_address.zip_code |Validator::ZIP_CODE
|
|
31
|
+
country |payment.billing_address.country |Validator::COUNTRY
|
|
32
|
+
phone |payment.billing_address.phone |Validator::PHONE
|
|
33
|
+
ipaddress |payment.customer.ip_address |Validator::IP
|
|
34
|
+
email |payment.customer.email |Validator::EMAIL
|
|
35
|
+
card_printed_name |payment.credit_card.card_printed_name |Validator::LONG_STRING
|
|
36
|
+
credit_card_number |payment.credit_card.credit_card_number |Validator::CREDIT_CARD_NUMBER
|
|
37
|
+
expire_month |payment.credit_card.expire_month |Validator::MONTH
|
|
38
|
+
expire_year |payment.credit_card.expire_year |Validator::YEAR
|
|
39
|
+
cvv2 |payment.credit_card.cvv2 |Validator::CVV2
|
|
40
|
+
redirect_url |query_config.redirect_url |Validator::URL
|
|
41
41
|
|
|
42
42
|
##### Необязательные параметры запроса
|
|
43
43
|
|
|
44
44
|
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
45
45
|
--------------------|-----------------------------------|-----------------
|
|
46
|
-
first_name |payment.customer.
|
|
47
|
-
last_name |payment.customer.
|
|
46
|
+
first_name |payment.customer.first_name |Validator::MEDIUM_STRING
|
|
47
|
+
last_name |payment.customer.last_name |Validator::MEDIUM_STRING
|
|
48
48
|
ssn |payment.customer.ssn |Validator::SSN
|
|
49
49
|
birthday |payment.customer.birthday |Validator::DATE
|
|
50
|
-
state |payment.
|
|
51
|
-
cell_phone |payment.
|
|
50
|
+
state |payment.billing_address.state |Validator::COUNTRY
|
|
51
|
+
cell_phone |payment.billing_address.cell_phone |Validator::PHONE
|
|
52
52
|
destination |payment.destination |Validator::LONG_STRING
|
|
53
|
-
site_url |
|
|
54
|
-
server_callback_url |
|
|
53
|
+
site_url |query_config.site_url |Validator::URL
|
|
54
|
+
server_callback_url |query_config.callback_url |Validator::URL
|
|
55
55
|
|
|
56
|
-
[Пример выполнения запроса preauth](../../example/preauth.
|
|
56
|
+
[Пример выполнения запроса preauth](../../example/preauth.rb)
|
|
57
57
|
|
|
58
58
|
## <a name="capture"></a> Запрос "capture"
|
|
59
59
|
|
|
@@ -63,11 +63,11 @@ server_callback_url |queryConfig.callbackUrl |Validator::URL
|
|
|
63
63
|
|
|
64
64
|
Поле запроса |Цепочка свойств платежа|Правило валидации
|
|
65
65
|
--------------------|-----------------------|-----------------
|
|
66
|
-
client_orderid |payment.
|
|
67
|
-
orderid |payment.
|
|
68
|
-
login |
|
|
66
|
+
client_orderid |payment.client_id |Validator::ID
|
|
67
|
+
orderid |payment.paynet_id |Validator::ID
|
|
68
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
69
69
|
|
|
70
|
-
[Пример выполнения запроса capture](../../example/capture.
|
|
70
|
+
[Пример выполнения запроса capture](../../example/capture.rb)
|
|
71
71
|
|
|
72
72
|
## <a name="status"></a> Запрос "status"
|
|
73
73
|
|
|
@@ -89,13 +89,13 @@ login |queryConfig.login |Validator::MEDIUM_STRING
|
|
|
89
89
|
|
|
90
90
|
Поле запроса |Цепочка свойств платежа|Правило валидации
|
|
91
91
|
--------------------|-----------------------|-----------------
|
|
92
|
-
client_orderid |payment.
|
|
93
|
-
orderid |payment.
|
|
94
|
-
login |
|
|
92
|
+
client_orderid |payment.client_id |Validator::ID
|
|
93
|
+
orderid |payment.paynet_id |Validator::ID
|
|
94
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
95
95
|
|
|
96
|
-
[Пример выполнения запроса status](../../example/status.
|
|
96
|
+
[Пример выполнения запроса status](../../example/status.rb)
|
|
97
97
|
|
|
98
|
-
## <a name="3d-redirect"> Обработка результата платежа после 3D-авторизации (только при выполнении запроса **[preauth](#preauth)**)
|
|
98
|
+
## <a name="3d-redirect"></a> Обработка результата платежа после 3D-авторизации (только при выполнении запроса **[preauth](#preauth)**)
|
|
99
99
|
|
|
100
100
|
Если при обработке платежа выполнялась 3D-авторизация, то при возвращении пользователя с формы авторизации на сервис мерчанта будут переданы данные с результатом обработки платежа. Обработка этих данных совпадает с обработкой данных для [sale-form, preauth-form или transfer-form](05-payment-form-integration.md) и описана в [базовом примере использования библиотеки](../00-basic-tutorial.md#stage_2).
|
|
101
101
|
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
## Общие положения
|
|
9
9
|
|
|
10
10
|
* В данной статье описывается исключительно работа с библиотекой. Полная информация о выполнении Transfer transactions расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Transfer_Transactions).
|
|
11
|
-
* Описание правил валидации можно найти в описании метода **[Validator
|
|
11
|
+
* Описание правил валидации можно найти в описании метода **[Validator.validate_by_rule()](../library-internals/02-validator.md#validate_by_rule)**.
|
|
12
12
|
* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
|
|
13
13
|
|
|
14
14
|
## <a name="create-card-ref"></a> Запрос "create-card-ref"
|
|
@@ -23,14 +23,13 @@
|
|
|
23
23
|
|
|
24
24
|
Поле запроса |Цепочка свойств платежа|Правило валидации
|
|
25
25
|
--------------------|-----------------------|-----------------
|
|
26
|
-
client_orderid |payment.
|
|
27
|
-
orderid |payment.
|
|
28
|
-
login |
|
|
26
|
+
client_orderid |payment.client_id |Validator::ID
|
|
27
|
+
orderid |payment.paynet_id |Validator::ID
|
|
28
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
29
29
|
|
|
30
|
-
[Пример выполнения запроса create-card-ref](../../example/create-card-ref.
|
|
30
|
+
[Пример выполнения запроса create-card-ref](../../example/create-card-ref.rb)
|
|
31
31
|
|
|
32
|
-
После выполнения данного запроса будет получен id сохраненной кредитной карты и создан объект **[RecurrentCard](../library-internals/00-payment-data.md#RecurrentCard)**. Получить доступ к **RecurrentCard** можно с помощью вызова
|
|
33
|
-
`$payment->getRecurrentCardFrom()`, а к ее id с помощью вызова `$payment->getRecurrentCardFrom()->getCardReferenceId()`
|
|
32
|
+
После выполнения данного запроса будет получен id сохраненной кредитной карты и создан объект **[RecurrentCard](../library-internals/00-payment-data.md#RecurrentCard)**. Получить доступ к **RecurrentCard** можно с помощью вызова `payment_transaction.payment.recurrent_card_from`, а к ее id с помощью вызова `payment_transaction.payment.recurrent_card_from.card_reference_id`
|
|
34
33
|
|
|
35
34
|
## <a name="transfer-by-ref"></a> Запрос "transfer-by-ref"
|
|
36
35
|
|
|
@@ -42,24 +41,24 @@ login |queryConfig.login |Validator::MEDIUM_STRING
|
|
|
42
41
|
|
|
43
42
|
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
44
43
|
------------------------|-----------------------------------|-----------------
|
|
45
|
-
client_orderid |payment.
|
|
44
|
+
client_orderid |payment.client_id |Validator::ID
|
|
46
45
|
amount |payment.amount |Validator::AMOUNT
|
|
47
46
|
currency |payment.currency |Validator::CURRENCY
|
|
48
|
-
ipaddress |payment.customer.
|
|
49
|
-
destination-card-ref-id |payment.
|
|
50
|
-
login |
|
|
47
|
+
ipaddress |payment.customer.ip_address |Validator::IP
|
|
48
|
+
destination-card-ref-id |payment.recurrent_card_to.paynet_id|Validator::ID
|
|
49
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
51
50
|
|
|
52
51
|
##### Необязательные параметры запроса
|
|
53
52
|
|
|
54
|
-
Поле запроса |Цепочка свойств платежа
|
|
55
|
-
|
|
56
|
-
order_desc |payment.description
|
|
57
|
-
source-card-ref-id |payment.
|
|
58
|
-
cvv2 |payment.
|
|
59
|
-
redirect_url |
|
|
60
|
-
server_callback_url |
|
|
53
|
+
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
54
|
+
------------------------|-------------------------------------|-----------------
|
|
55
|
+
order_desc |payment.description |Validator::LONG_STRING
|
|
56
|
+
source-card-ref-id |payment.recurrent_card_from.paynet_id|Validator::ID
|
|
57
|
+
cvv2 |payment.recurrent_card_from.cvv2 |Validator::CVV2
|
|
58
|
+
redirect_url |query_config.redirect_url |Validator::URL
|
|
59
|
+
server_callback_url |query_config.callback_url |Validator::URL
|
|
61
60
|
|
|
62
|
-
[Пример выполнения запроса transfer-by-ref](../../example/transfer-by-ref.
|
|
61
|
+
[Пример выполнения запроса transfer-by-ref](../../example/transfer-by-ref.rb)
|
|
63
62
|
|
|
64
63
|
## <a name="status"></a> Запрос "status"
|
|
65
64
|
|
|
@@ -77,11 +76,11 @@ server_callback_url |queryConfig.callbackUrl |Validator::URL
|
|
|
77
76
|
|
|
78
77
|
Поле запроса |Цепочка свойств платежа|Правило валидации
|
|
79
78
|
--------------------|-----------------------|-----------------
|
|
80
|
-
client_orderid |payment.
|
|
81
|
-
orderid |payment.
|
|
82
|
-
login |
|
|
79
|
+
client_orderid |payment.client_id |Validator::ID
|
|
80
|
+
orderid |payment.paynet_id |Validator::ID
|
|
81
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
83
82
|
|
|
84
|
-
[Пример выполнения запроса status](../../example/status.
|
|
83
|
+
[Пример выполнения запроса status](../../example/status.rb)
|
|
85
84
|
|
|
86
85
|
## <a name="callback"></a> Обработка обратного вызова
|
|
87
86
|
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
## Общие положения
|
|
8
8
|
|
|
9
9
|
* В данной статье описывается исключительно работа с библиотекой. Полная информация о выполнении Return transactions расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Return_Transactions).
|
|
10
|
-
* Описание правил валидации можно найти в описании метода **[Validator
|
|
10
|
+
* Описание правил валидации можно найти в описании метода **[Validator.validate_by_rule()](../library-internals/02-validator.md#validate_by_rule)**.
|
|
11
11
|
* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
|
|
12
12
|
|
|
13
13
|
## <a name="return"></a> Запрос "return"
|
|
@@ -20,14 +20,14 @@
|
|
|
20
20
|
|
|
21
21
|
Поле запроса |Цепочка свойств платежа|Правило валидации
|
|
22
22
|
----------------|-----------------------|-----------------
|
|
23
|
-
client_orderid |payment.
|
|
24
|
-
orderid |payment.
|
|
23
|
+
client_orderid |payment.client_id |Validator::ID
|
|
24
|
+
orderid |payment.paynet_id |Validator::ID
|
|
25
25
|
amount |payment.amount |Validator::AMOUNT
|
|
26
26
|
currency |payment.currency |Validator::CURRENCY
|
|
27
27
|
comment |payment.comment |Validator::MEDIUM_STRING
|
|
28
|
-
login |
|
|
28
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
29
29
|
|
|
30
|
-
[Пример выполнения запроса return](../../example/return.
|
|
30
|
+
[Пример выполнения запроса return](../../example/return.rb)
|
|
31
31
|
|
|
32
32
|
## <a name="status"></a> Запрос "status"
|
|
33
33
|
|
|
@@ -45,8 +45,8 @@ login |queryConfig.login |Validator::MEDIUM_STRING
|
|
|
45
45
|
|
|
46
46
|
Поле запроса |Цепочка свойств платежа|Правило валидации
|
|
47
47
|
----------------|-----------------------|-----------------
|
|
48
|
-
client_orderid |payment.
|
|
49
|
-
orderid |payment.
|
|
50
|
-
login |
|
|
48
|
+
client_orderid |payment.client_id |Validator::ID
|
|
49
|
+
orderid |payment.paynet_id |Validator::ID
|
|
50
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
51
51
|
|
|
52
|
-
[Пример выполнения запроса status](../../example/status.
|
|
52
|
+
[Пример выполнения запроса status](../../example/status.rb)
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
## Общие положения
|
|
10
10
|
|
|
11
11
|
* В данной статье описывается исключительно работа с библиотекой. Полная информация о выполнении Recurrent transactions расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Recurrent_Transactions).
|
|
12
|
-
* Описание правил валидации можно найти в описании метода **[Validator
|
|
12
|
+
* Описание правил валидации можно найти в описании метода **[Validator.validate_by_rule()](../library-internals/02-validator.md#validate_by_rule)**.
|
|
13
13
|
* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
|
|
14
14
|
|
|
15
15
|
## <a name="create-card-ref"></a> Запрос "create-card-ref"
|
|
@@ -24,14 +24,13 @@
|
|
|
24
24
|
|
|
25
25
|
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
26
26
|
--------------------|-------------------------------|-----------------
|
|
27
|
-
client_orderid |
|
|
28
|
-
orderid |
|
|
29
|
-
login |
|
|
27
|
+
client_orderid |payment.client_id |Validator::ID
|
|
28
|
+
orderid |payment.paynet_id |Validator::ID
|
|
29
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
30
30
|
|
|
31
|
-
[Пример выполнения запроса create-card-ref](../../example/create-card-ref.
|
|
31
|
+
[Пример выполнения запроса create-card-ref](../../example/create-card-ref.rb)
|
|
32
32
|
|
|
33
|
-
После выполнения данного запроса будет получен id сохраненной кредитной карты и создан объект **[RecurrentCard](../library-internals/00-payment-data.md#RecurrentCard)**. Получить доступ к **RecurrentCard** можно с помощью вызова
|
|
34
|
-
`$payment->getRecurrentCardFrom()`, а к ее id с помощью вызова `$payment->getRecurrentCardFrom()->getCardReferenceId()`
|
|
33
|
+
После выполнения данного запроса будет получен id сохраненной кредитной карты и создан объект **[RecurrentCard](../library-internals/00-payment-data.md#RecurrentCard)**. Получить доступ к **RecurrentCard** можно с помощью вызова `payment_transaction.payment.recurrent_card_from`, а к ее id с помощью вызова `payment_transaction.payment.recurrent_card_from.card_reference_id`
|
|
35
34
|
|
|
36
35
|
## <a name="get-card-info"></a> Запрос "get-card-info"
|
|
37
36
|
|
|
@@ -40,19 +39,19 @@ login |queryConfig.login |Validator::MEDIUM_STRING
|
|
|
40
39
|
|
|
41
40
|
##### Обязательные параметры запроса
|
|
42
41
|
|
|
43
|
-
Поле запроса |Цепочка свойств платежа
|
|
44
|
-
|
|
45
|
-
cardrefid |
|
|
46
|
-
login |
|
|
42
|
+
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
43
|
+
--------------------|-------------------------------------|-----------------
|
|
44
|
+
cardrefid |payment.recurrent_card_from.paynet_id|Validator::ID
|
|
45
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
47
46
|
|
|
48
|
-
[Пример выполнения запроса get-card-info](../../example/get-card-info.
|
|
47
|
+
[Пример выполнения запроса get-card-info](../../example/get-card-info.rb)
|
|
49
48
|
|
|
50
|
-
После выполнения данного запроса будут получены данные сохраненной кредитной карты и создан объект **[RecurrentCard](../library-internals/00-payment-data.md#RecurrentCard)**. Получить доступ к **RecurrentCard** можно с помощью вызова
|
|
51
|
-
* **cardPrintedName** - данные доступны с помощью вызова
|
|
52
|
-
* **expireYear** - данные доступны с помощью вызова
|
|
53
|
-
* **expireMonth** - данные доступны с помощью вызова
|
|
54
|
-
* **bin** - данные доступны с помощью вызова
|
|
55
|
-
* **lastFourDigits** - данные доступны с помощью вызова
|
|
49
|
+
После выполнения данного запроса будут получены данные сохраненной кредитной карты и создан объект **[RecurrentCard](../library-internals/00-payment-data.md#RecurrentCard)**. Получить доступ к **RecurrentCard** можно с помощью вызова `payment_transaction.payment.recurrent_card_from`. В объекте будут заполнены следующие данные:
|
|
50
|
+
* **cardPrintedName** - данные доступны с помощью вызова `payment_transaction.payment.recurrent_card_from.card_printed_name`
|
|
51
|
+
* **expireYear** - данные доступны с помощью вызова `payment_transaction.payment.recurrent_card_from.expire_year`
|
|
52
|
+
* **expireMonth** - данные доступны с помощью вызова `payment_transaction.payment.recurrent_card_from.expire_month`
|
|
53
|
+
* **bin** - данные доступны с помощью вызова `payment_transaction.payment.recurrent_card_from.bin`
|
|
54
|
+
* **lastFourDigits** - данные доступны с помощью вызова `payment_transaction.payment.recurrent_card_from.last_four_digits`
|
|
56
55
|
|
|
57
56
|
## <a name="make-rebill"></a> Запрос "make-rebill"
|
|
58
57
|
|
|
@@ -62,25 +61,25 @@ login |queryConfig.login |Validator::MEDIUM_STRING
|
|
|
62
61
|
|
|
63
62
|
##### Обязательные параметры запроса
|
|
64
63
|
|
|
65
|
-
Поле запроса |Цепочка свойств платежа
|
|
66
|
-
|
|
67
|
-
client_orderid |payment.
|
|
68
|
-
order_desc |payment.description
|
|
69
|
-
amount |payment.amount
|
|
70
|
-
currency |payment.currency
|
|
71
|
-
ipaddress |payment.customer.
|
|
72
|
-
cardrefid |payment.
|
|
73
|
-
login |
|
|
64
|
+
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
65
|
+
--------------------|-------------------------------------|-----------------
|
|
66
|
+
client_orderid |payment.client_id |Validator::ID
|
|
67
|
+
order_desc |payment.description |Validator::LONG_STRING
|
|
68
|
+
amount |payment.amount |Validator::AMOUNT
|
|
69
|
+
currency |payment.currency |Validator::CURRENCY
|
|
70
|
+
ipaddress |payment.customer.ip_address |Validator::IP
|
|
71
|
+
cardrefid |payment.recurrent_card_from.paynet_id|Validator::ID
|
|
72
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
74
73
|
|
|
75
74
|
##### Необязательные параметры запроса
|
|
76
75
|
|
|
77
|
-
Поле запроса |Цепочка свойств платежа
|
|
78
|
-
|
|
79
|
-
comment |payment.comment
|
|
80
|
-
cvv2 |payment.
|
|
81
|
-
server_callback_url |
|
|
76
|
+
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
77
|
+
--------------------|---------------------------------|-----------------
|
|
78
|
+
comment |payment.comment |Validator::MEDIUM_STRING
|
|
79
|
+
cvv2 |payment.recurrent_card_from.cvv2 |Validator::CVV2
|
|
80
|
+
server_callback_url |query_config.callback_url |Validator::URL
|
|
82
81
|
|
|
83
|
-
[Пример выполнения запроса make-rebill](../../example/make-rebill.
|
|
82
|
+
[Пример выполнения запроса make-rebill](../../example/make-rebill.rb)
|
|
84
83
|
|
|
85
84
|
## <a name="status"></a> Запрос "status"
|
|
86
85
|
|
|
@@ -98,11 +97,11 @@ server_callback_url |queryConfig.callbackUrl |Validator::URL
|
|
|
98
97
|
|
|
99
98
|
Поле запроса |Цепочка свойств платежа|Правило валидации
|
|
100
99
|
--------------------|-----------------------|-----------------
|
|
101
|
-
client_orderid |payment.
|
|
102
|
-
orderid |payment.
|
|
103
|
-
login |
|
|
100
|
+
client_orderid |payment.client_id |Validator::ID
|
|
101
|
+
orderid |payment.paynet_id |Validator::ID
|
|
102
|
+
login |query_config.login |Validator::MEDIUM_STRING
|
|
104
103
|
|
|
105
|
-
[Пример выполнения запроса status](../../example/status.
|
|
104
|
+
[Пример выполнения запроса status](../../example/status.rb)
|
|
106
105
|
|
|
107
106
|
## <a name="callback"></a> Обработка обратного вызова
|
|
108
107
|
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
## Общие положения
|
|
4
4
|
|
|
5
5
|
* В данной статье описывается исключительно работа с библиотекой. Полная информация о выполнении Payment form integration расположена в [статье в wiki PaynetEasy](http://wiki.payneteasy.com/index.php/PnE:Payment_Form_integration).
|
|
6
|
-
* Описание правил валидации можно найти в описании метода **[Validator
|
|
6
|
+
* Описание правил валидации можно найти в описании метода **[Validator.validate_by_rule()](../library-internals/02-validator.md#validate_by_rule)**.
|
|
7
7
|
* Описание работы с цепочками свойств можно найти в описании класса **[PropertyAccessor](../library-internals/03-property-accessor.md)**
|
|
8
8
|
|
|
9
9
|
## <a name="form"></a> Запросы "sale-form", "preauth-form", "transfer-form"
|
|
@@ -18,37 +18,37 @@
|
|
|
18
18
|
|
|
19
19
|
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
20
20
|
--------------------|-----------------------------------|-----------------
|
|
21
|
-
client_orderid |payment.
|
|
21
|
+
client_orderid |payment.client_id |Validator::ID
|
|
22
22
|
order_desc |payment.description |Validator::LONG_STRING
|
|
23
23
|
amount |payment.amount |Validator::AMOUNT
|
|
24
24
|
currency |payment.currency |Validator::CURRENCY
|
|
25
|
-
address1 |payment.
|
|
26
|
-
city |payment.
|
|
27
|
-
zip_code |payment.
|
|
28
|
-
country |payment.
|
|
29
|
-
phone |payment.
|
|
30
|
-
ipaddress |payment.customer.
|
|
25
|
+
address1 |payment.billing_address.first_line |Validator::MEDIUM_STRING
|
|
26
|
+
city |payment.billing_address.city |Validator::MEDIUM_STRING
|
|
27
|
+
zip_code |payment.billing_address.zip_code |Validator::ZIP_CODE
|
|
28
|
+
country |payment.billing_address.country |Validator::COUNTRY
|
|
29
|
+
phone |payment.billing_address.phone |Validator::PHONE
|
|
30
|
+
ipaddress |payment.customer.ip_address |Validator::IP
|
|
31
31
|
email |payment.customer.email |Validator::EMAIL
|
|
32
|
-
redirect_url |
|
|
32
|
+
redirect_url |query_config.redirect_url |Validator::URL
|
|
33
33
|
|
|
34
34
|
##### Необязательные параметры запроса
|
|
35
35
|
|
|
36
36
|
Поле запроса |Цепочка свойств платежа |Правило валидации
|
|
37
37
|
--------------------|-----------------------------------|-----------------
|
|
38
|
-
first_name |payment.customer.
|
|
39
|
-
last_name |payment.customer.
|
|
38
|
+
first_name |payment.customer.first_name |Validator::MEDIUM_STRING
|
|
39
|
+
last_name |payment.customer.last_name |Validator::MEDIUM_STRING
|
|
40
40
|
ssn |payment.customer.ssn |Validator::SSN
|
|
41
41
|
birthday |payment.customer.birthday |Validator::DATE
|
|
42
|
-
state |payment.
|
|
43
|
-
cell_phone |payment.
|
|
44
|
-
site_url |
|
|
45
|
-
server_callback_url |
|
|
42
|
+
state |payment.billing_address.state |Validator::COUNTRY
|
|
43
|
+
cell_phone |payment.billing_address.cell_phone |Validator::PHONE
|
|
44
|
+
site_url |query_config.site_url |Validator::URL
|
|
45
|
+
server_callback_url |query_config.callback_url |Validator::URL
|
|
46
46
|
|
|
47
|
-
[Пример выполнения запроса sale-form](../../example/sale-form.
|
|
48
|
-
[Пример выполнения запроса preauth-form](../../example/preauth-form.
|
|
49
|
-
[Пример выполнения запроса transfer-form](../../example/transfer-form.
|
|
47
|
+
[Пример выполнения запроса sale-form](../../example/sale-form.rb)
|
|
48
|
+
[Пример выполнения запроса preauth-form](../../example/preauth-form.rb)
|
|
49
|
+
[Пример выполнения запроса transfer-form](../../example/transfer-form.rb)
|
|
50
50
|
|
|
51
|
-
## <a name="form-redirect"> Обработка результата платежа после возвращения клиента с платежной формы
|
|
51
|
+
## <a name="form-redirect"></a> Обработка результата платежа после возвращения клиента с платежной формы
|
|
52
52
|
|
|
53
53
|
При возвращении пользователя с платежной формы на сервис мерчанта будут переданы данные с результатом обработки платежа. Обработка этих данных описана в [базовом примере использования библиотеки](../00-basic-tutorial.md#stage_2).
|
|
54
54
|
|