-
Notifications
You must be signed in to change notification settings - Fork 1
/
Charge.php
206 lines (201 loc) · 11.8 KB
/
Charge.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
<?php
namespace Dfe\Robokassa;
/**
* 2017-04-10
* 2017-04-16
* «Description of variables, parameters and values»: http://docs.robokassa.ru/en#2501
* «Описание переменных, параметров и значений»: http://docs.robokassa.ru/ru#1061
* @method Method m()
* @method Settings s()
*/
final class Charge extends \Df\PaypalClone\Charge {
/**
* 2017-08-19
* 2017-04-16
* «Means the amount payable (in other words, the price of the order placed by the client).
* The format of presentation – dot-delimited digits. For example 123.45.
* The amount should be denominated in RUB.
* However, if the prices are denominated (e.g.) in USD on your website
* when issuing the invoice you need to specify the amount converted from USD to RUB.
* (see Optional Parameters OutSumCurrency).»
* http://docs.robokassa.ru/en#2504
* «Требуемая к получению сумма (буквально — стоимость заказа, сделанного клиентом).
* Формат представления — число, разделитель — точка, например: 123.45.
* Сумма должна быть указана в рублях.
* Но, если стоимость товаров у Вас на сайте указана, например, в долларах,
* то при выставлении счёта к оплате Вам необходимо указывать уже пересчитанную сумму
* из долларов в рубли. См. необязательный параметр OutSumCurrency.»
* http://docs.robokassa.ru/ru#1188
* Required.
* @override
* @see \Df\PaypalClone\Charge::k_Amount()
* @used-by \Df\PaypalClone\Charge::p()
*/
protected function k_Amount():string {return 'OutSum';}
/**
* 2017-08-19
* 2017-04-16
* «The buyer’s E-Mail is automatically inserted into ROBOKASSA payment form.
* The user may change it in the process of payment.
* It will be used if the user already specified his contact E-Mail on your website.»
* http://docs.robokassa.ru/en#2514
* «E-Mail покупателя автоматически подставляется в платёжную форму ROBOKASSA.
* Пользователь может изменить его в процессе оплаты.»
* http://docs.robokassa.ru/ru#1202
* Optional.
* @override
* @see \Df\PaypalClone\Charge::k_Email()
* @used-by \Df\PaypalClone\Charge::p()
*/
protected function k_Email():string {return 'Email';}
/**
* 2017-08-19
* 2017-04-16
* «Means the Shop Identifier in ROBOKASSA you specified upon creation of the Shop.»
* http://docs.robokassa.ru/en#2503
* «Идентификатор магазина в ROBOKASSA, который Вы придумали при создании магазина.»
* http://docs.robokassa.ru/ru#1068
* Required.
* @override
* @see \Df\PaypalClone\Charge::k_MerchantId()
* @used-by \Df\PaypalClone\Charge::p()
*/
protected function k_MerchantId():string {return 'MerchantLogin';}
/**
* 2017-04-10
* 2017-04-16
* «Means your invoice number.
* The optional parameter, but we strongly recommend using it.
* It should be unique each time your client is redirected for payment to our system.
* It may vary from 1 to 2147483647 (2^31-1).
* If this parameter is passed, it should be included in the calculation of the checksum
* (SignatureValue).»
* http://docs.robokassa.ru/en#2509
* Номер счета в магазине.
* Необязательный параметр, но мы настоятельно рекомендуем его использовать.
* Значение этого параметра должно быть уникальным для каждой оплаты.
* Может принимать значения от 1 до 2147483647 (2^31-1).
* Если значение параметра пустое, или равно 0, или параметр вовсе не указан,
* то при создании операции оплаты ему автоматически будет присвоено уникальное значение.
* Используйте данную возможность только в очень простых магазинах,
* где не требуется какого-либо контроля оплаты.
* Если параметр передан, то он должен быть включён в расчёт контрольной суммы (SignatureValue).
* http://docs.robokassa.ru/ru#1194
* @override
* @see \Df\PaypalClone\Charge::k_RequestId()
* @used-by \Df\PaypalClone\Charge::p()
*/
protected function k_RequestId():string {return 'InvId';}
/**
* 2017-04-10
* http://docs.robokassa.ru/en#2506
* http://docs.robokassa.ru/ru#1190
* @override
* @see \Df\PaypalClone\Charge::k_Signature()
* @used-by \Df\PaypalClone\Charge::p()
*/
protected function k_Signature():string {return 'SignatureValue';}
/**
* 2017-04-10
* @override
* @see \Df\PaypalClone\Charge::pCharge()
* @used-by \Df\PaypalClone\Charge::p()
* @return array(string => mixed)
*/
protected function pCharge():array {$s = $this->s(); return [
# 2017-04-16
# «Optional, means language the client will use to communicate with your website.
# It can have the following values: en, ru.
# This is in accordance with ISO 3166-1.
# i.e. you initially choose the language of ROBOKASSA interface the client will see.
# If no language is chosen (used),
# then the language will be as in the regional settings of the client’s browser.
# If the regional settings are other than Russian, then English will automatically switch on.»
# http://docs.robokassa.ru/en#2550
# «Язык общения с клиентом (в соответствии с ISO 3166-1).
# Определяет на каком языке будет страница ROBOKASSA, на которую попадёт покупатель.
# Может принимать значения: en, ru.
# Если параметр не передан, то используются региональные настройки браузера покупателя.
# Для значений отличных от ru или en используется английский язык.»
# http://docs.robokassa.ru/ru#1202
# Optional.
# Я явно передаю значение этого параметра,
# чтобы мне было удобно снимать демо-ролик с требуемым мне языком интерфейса.
'Culture' => df_lang_ru_en()
# 2017-04-16
# «Means encoding, in which cash-desk HTML code will return.
# By default: windows-1251.
# The same parameter ensures
# that purchase description (sInvDesc) is correctly displayed in ROBOKASSA interface
# and that Additional User Parameters are correctly translated
# if their values are in a language other than English.»
# http://docs.robokassa.ru/en#2513
# «Кодировка, в которой отображается страница ROBOKASSA.
# По умолчанию: windows-1251.
# Этот же параметр влияет на корректность отображения описания покупки (InvDesc)
# в интерфейсе ROBOKASSA,
# и на правильность передачи Дополнительных пользовательских параметров,
# если в их значениях присутствует язык отличный от английского.»
# http://docs.robokassa.ru/ru#1201
# Optional.
,'Encoding' => 'utf-8'
# 2017-04-16
# «Means proposed currency of payment.
# This is the payment option you recommend to your buyers/users.
# If this parameter is specified, then the buyer during the transition to the site ROBOKASSA
# will get to the payment page with the specified payment method.
# The buyer may change it in the process of payment.»
# http://docs.robokassa.ru/en#2510
# «Предлагаемый способ оплаты.
# Тот вариант оплаты, который Вы рекомендуете использовать своим покупателям.
# Если параметр указан, то покупатель при переходе на сайт ROBOKASSA
# попадёт на страницу оплаты с выбранным способом оплаты.
# Покупатель может изменить его в процессе оплаты.»
# http://docs.robokassa.ru/ru#1196
# Optional.
,'IncCurrLabel' => $this->m()->option()
# 2017-04-16
# «Means description of the purchase.
# Only English or Russian letters, digits and punctuation marks may be used.
# Maximum 100 characters.
# In other words, this is the name of the goods the client is purchasing.
# This information is reflected in ROBOKASSA interface
# and the E-Receipt we issue to the client after completion of payment.
# It may be reflected correctly if the optional parameter Encoding is activated
# (see Optional Parameters).»
# http://docs.robokassa.ru/en#2505
# «Описание покупки,
# можно использовать только символы английского или русского алфавита, цифры и знаки препинания.
# Максимальная длина — 100 символов.
# Эта информация отображается в интерфейсе ROBOKASSA и в Электронной квитанции,
# которую мы выдаём клиенту после успешного платежа.
# Корректность отображения зависит от необязательного параметра Encoding
# (см. Необязательные параметры).»
# http://docs.robokassa.ru/ru#1189
# Required.
# @todo Проверить, что будет, если передать недопустимые символы.
,'InvDesc' => $this->description()
# 2017-04-16
# «In order to initiate test operation of payment through your shop,
# you must add the parameter IsTest with the value 1 to the script.
# If this parameter is absent, or as a parameter value IsTest was transferred to 0,
# or the value is empty, such a request is not considered as a test payment
# and initializes the normal payment operation..»
# http://docs.robokassa.ru/en#3914
# «Для того, что бы со стороны магазина инициировать тестовую операцию оплаты,
# в скрипт к остальным параметрам необходимо добавить параметр IsTest со значением 1.
# Если данный параметр вообще отсутствует, или в качестве значения параметра IsTest передан 0,
# или значение параметра пусто, то такой запрос не считается тестовым
# и происходит инициализация обычной операции оплаты.»
# http://docs.robokassa.ru/ru#2388
,'isTest' => $s->test() ? 1 : 0
# 2017-04-16
# «Передача этого параметра (Ip конечного пользователя) желательна для усиления безопастности,
# предотвращению фрода и противодействию мошенникам.
# Если этот параметр передан, то он будет встроен в расчет контрольной суммы SignatureValue.
# Этот параметр пользователь передает при оплате.
# При расчете контрольной суммы UserIp ставится перед Пароль#1.»
# http://docs.robokassa.ru/ru#6415
,'UserIP' => $this->customerIp()
];}
}