pagseguro-oficial 2.5.0 → 2.6.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (140) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +13 -1
  3. data/CONTRIBUTING.md +39 -0
  4. data/Dockerfile +20 -0
  5. data/README.md +22 -0
  6. data/docker-compose.yml +5 -0
  7. data/examples/checkout/create_payment_request.rb +1 -1
  8. data/examples/direct/create_transaction_using_boleto.rb +1 -1
  9. data/examples/direct/create_transaction_using_credit_card.rb +1 -1
  10. data/examples/direct/create_transaction_using_online_debit.rb +1 -1
  11. data/examples/preapproval/cancel_preapproval.rb +26 -0
  12. data/examples/preapproval/change_preapproval_payment.rb +50 -0
  13. data/examples/preapproval/change_preapproval_status.rb +29 -0
  14. data/examples/preapproval/charge_preapproval.rb +36 -0
  15. data/examples/preapproval/create_preapproval.rb +68 -0
  16. data/examples/preapproval/create_preapproval_auto.rb +53 -0
  17. data/examples/preapproval/create_preapproval_discount.rb +30 -0
  18. data/examples/preapproval/create_preapproval_manual.rb +58 -0
  19. data/examples/preapproval/create_preapproval_transparent.rb +41 -0
  20. data/examples/preapproval/preapproval_retry.rb +29 -0
  21. data/examples/preapproval/search/search_by_date_interval.rb +45 -0
  22. data/examples/preapproval/search/search_by_days_interval.rb +46 -0
  23. data/examples/preapproval/search/search_by_notification_code.rb +50 -0
  24. data/examples/preapproval/search/search_by_subscription_code.rb +50 -0
  25. data/examples/preapproval/search/search_subscription_payment_orders.rb +53 -0
  26. data/examples/split_payment/create_payment_request.rb +1 -1
  27. data/examples/split_payment/create_transaction_using_boleto.rb +118 -0
  28. data/examples/split_payment/create_transaction_using_credit_card.rb +152 -0
  29. data/lib/pagseguro.rb +33 -1
  30. data/lib/pagseguro/credit_card_transaction_request.rb +1 -1
  31. data/lib/pagseguro/document.rb +8 -0
  32. data/lib/pagseguro/holder.rb +8 -0
  33. data/lib/pagseguro/manual_subscription_charger.rb +59 -0
  34. data/lib/pagseguro/manual_subscription_charger/request_serializer.rb +50 -0
  35. data/lib/pagseguro/manual_subscription_charger/response.rb +36 -0
  36. data/lib/pagseguro/manual_subscription_charger/response_serializer.rb +17 -0
  37. data/lib/pagseguro/payment_request/request_serializer.rb +25 -1
  38. data/lib/pagseguro/receiver.rb +3 -0
  39. data/lib/pagseguro/request.rb +32 -2
  40. data/lib/pagseguro/sender.rb +21 -3
  41. data/lib/pagseguro/subscription.rb +132 -0
  42. data/lib/pagseguro/subscription/request_serializer.rb +129 -0
  43. data/lib/pagseguro/subscription/response.rb +49 -0
  44. data/lib/pagseguro/subscription/response_serializer.rb +62 -0
  45. data/lib/pagseguro/subscription/subscription_search.rb +135 -0
  46. data/lib/pagseguro/subscription_canceller.rb +30 -0
  47. data/lib/pagseguro/subscription_canceller/response.rb +34 -0
  48. data/lib/pagseguro/subscription_change_payment.rb +46 -0
  49. data/lib/pagseguro/subscription_change_payment/request_serializer.rb +80 -0
  50. data/lib/pagseguro/subscription_change_payment/response.rb +26 -0
  51. data/lib/pagseguro/subscription_change_status.rb +50 -0
  52. data/lib/pagseguro/subscription_change_status/request_serializer.rb +28 -0
  53. data/lib/pagseguro/subscription_change_status/response.rb +26 -0
  54. data/lib/pagseguro/subscription_discount.rb +41 -0
  55. data/lib/pagseguro/subscription_discount/request_serializer.rb +34 -0
  56. data/lib/pagseguro/subscription_discount/response.rb +34 -0
  57. data/lib/pagseguro/subscription_payment_method.rb +21 -0
  58. data/lib/pagseguro/subscription_payment_order.rb +57 -0
  59. data/lib/pagseguro/subscription_payment_order/response.rb +37 -0
  60. data/lib/pagseguro/subscription_payment_order/response_serializer.rb +51 -0
  61. data/lib/pagseguro/subscription_plan.rb +69 -0
  62. data/lib/pagseguro/subscription_plan/request_serializer.rb +81 -0
  63. data/lib/pagseguro/subscription_plan/response.rb +36 -0
  64. data/lib/pagseguro/subscription_plan/response_serializer.rb +17 -0
  65. data/lib/pagseguro/subscription_retry.rb +35 -0
  66. data/lib/pagseguro/subscription_retry/response.rb +34 -0
  67. data/lib/pagseguro/subscription_search_payment_orders.rb +131 -0
  68. data/lib/pagseguro/subscription_transaction.rb +29 -0
  69. data/lib/pagseguro/subscription_transactions.rb +5 -0
  70. data/lib/pagseguro/transaction.rb +0 -10
  71. data/lib/pagseguro/transaction/serializer.rb +19 -2
  72. data/lib/pagseguro/transaction_request.rb +26 -1
  73. data/lib/pagseguro/transaction_request/request_serializer.rb +164 -1
  74. data/lib/pagseguro/version.rb +1 -1
  75. data/spec/fixtures/manual_subscription_charger/fail.xml +6 -0
  76. data/spec/fixtures/manual_subscription_charger/success.xml +4 -0
  77. data/spec/fixtures/subscription/fail.xml +6 -0
  78. data/spec/fixtures/subscription/find_success.xml +28 -0
  79. data/spec/fixtures/subscription/search_success.xml +18 -0
  80. data/spec/fixtures/subscription/success.xml +4 -0
  81. data/spec/fixtures/subscription_canceller/fail.xml +6 -0
  82. data/spec/fixtures/subscription_change_payment/fail.xml +7 -0
  83. data/spec/fixtures/subscription_change_status/fail.xml +7 -0
  84. data/spec/fixtures/subscription_discount/fail.xml +6 -0
  85. data/spec/fixtures/subscription_payment_order/success.xml +18 -0
  86. data/spec/fixtures/subscription_plan/fail.xml +6 -0
  87. data/spec/fixtures/subscription_plan/success.xml +4 -0
  88. data/spec/fixtures/subscription_retry/fail.xml +7 -0
  89. data/spec/fixtures/subscription_search_payment_orders/success.xml +43 -0
  90. data/spec/fixtures/transactions/without_status_and_type.xml +71 -0
  91. data/spec/pagseguro/credit_card_transaction_request_spec.rb +1 -1
  92. data/spec/pagseguro/document_spec.rb +15 -0
  93. data/spec/pagseguro/holder_spec.rb +1 -0
  94. data/spec/pagseguro/manual_subscription_charger/request_serializer_spec.rb +79 -0
  95. data/spec/pagseguro/manual_subscription_charger/response_serializer_spec.rb +10 -0
  96. data/spec/pagseguro/manual_subscription_charger/response_spec.rb +65 -0
  97. data/spec/pagseguro/manual_subscription_charger_spec.rb +68 -0
  98. data/spec/pagseguro/payment_request/request_serializer_spec.rb +54 -22
  99. data/spec/pagseguro/receiver_spec.rb +1 -0
  100. data/spec/pagseguro/sender_spec.rb +16 -2
  101. data/spec/pagseguro/subscription/request_serializer_spec.rb +233 -0
  102. data/spec/pagseguro/subscription/response_serializer_spec.rb +46 -0
  103. data/spec/pagseguro/subscription/response_spec.rb +79 -0
  104. data/spec/pagseguro/subscription/subscription_search_spec.rb +154 -0
  105. data/spec/pagseguro/subscription_canceller/response_spec.rb +58 -0
  106. data/spec/pagseguro/subscription_canceller_spec.rb +57 -0
  107. data/spec/pagseguro/subscription_change_payment/request_serializer_spec.rb +150 -0
  108. data/spec/pagseguro/subscription_change_payment/response_spec.rb +41 -0
  109. data/spec/pagseguro/subscription_change_payment_spec.rb +60 -0
  110. data/spec/pagseguro/subscription_change_status/request_serializer_spec.rb +19 -0
  111. data/spec/pagseguro/subscription_change_status/response_spec.rb +41 -0
  112. data/spec/pagseguro/subscription_change_status_spec.rb +53 -0
  113. data/spec/pagseguro/subscription_discount/request_serializer_spec.rb +27 -0
  114. data/spec/pagseguro/subscription_discount/response_spec.rb +58 -0
  115. data/spec/pagseguro/subscription_discount_spec.rb +60 -0
  116. data/spec/pagseguro/subscription_payment_method_spec.rb +10 -0
  117. data/spec/pagseguro/subscription_payment_order/response_serializer_spec.rb +24 -0
  118. data/spec/pagseguro/subscription_payment_order/response_spec.rb +55 -0
  119. data/spec/pagseguro/subscription_payment_order_spec.rb +27 -0
  120. data/spec/pagseguro/subscription_plan/request_serializer_spec.rb +253 -0
  121. data/spec/pagseguro/subscription_plan/response_serializer_spec.rb +10 -0
  122. data/spec/pagseguro/subscription_plan/response_spec.rb +65 -0
  123. data/spec/pagseguro/subscription_plan_spec.rb +118 -0
  124. data/spec/pagseguro/subscription_retry/response_spec.rb +58 -0
  125. data/spec/pagseguro/subscription_retry_spec.rb +62 -0
  126. data/spec/pagseguro/subscription_search_payment_order_spec.rb +129 -0
  127. data/spec/pagseguro/subscription_spec.rb +137 -0
  128. data/spec/pagseguro/subscription_transaction_spec.rb +24 -0
  129. data/spec/pagseguro/subscription_transactions_spec.rb +37 -0
  130. data/spec/pagseguro/transaction/response_spec.rb +0 -42
  131. data/spec/pagseguro/transaction/serializer_spec.rb +5 -6
  132. data/spec/pagseguro/transaction_request/request_serializer_spec.rb +623 -159
  133. data/spec/pagseguro/transaction_request_spec.rb +26 -0
  134. data/spec/pagseguro/transaction_spec.rb +0 -48
  135. data/spec/spec_helper.rb +1 -0
  136. metadata +154 -8
  137. data/examples/checkout/search/search_transaction_status_history.rb +0 -22
  138. data/lib/pagseguro/transaction/status_collection.rb +0 -20
  139. data/spec/fixtures/transactions/status_history.xml +0 -12
  140. data/spec/pagseguro/transaction/status_collection_spec.rb +0 -43
@@ -0,0 +1,41 @@
1
+ module PagSeguro
2
+ class SubscriptionDiscount
3
+ API_VERSION = :v2
4
+
5
+ include Extensions::MassAssignment
6
+ include Extensions::Credentiable
7
+
8
+ # Type of discount, it can be DISCOUNT_PERCENT or DISCOUNT_AMOUNT.
9
+ attr_accessor :type
10
+
11
+ # Value of discount
12
+ attr_accessor :value
13
+
14
+ # The code of subscription, not the plan
15
+ attr_accessor :code
16
+
17
+ # Set errors
18
+ def errors
19
+ @errors ||= Errors.new
20
+ end
21
+
22
+ # The server returns only with a 200 response in case of success.
23
+ def create
24
+ request = Request.put_xml("pre-approvals/#{code}/discount", credentials, xml_params)
25
+
26
+ Response.new(request, self).serialize
27
+
28
+ self
29
+ end
30
+
31
+ private
32
+
33
+ def after_initialize
34
+ @errors = Errors.new
35
+ end
36
+
37
+ def xml_params
38
+ RequestSerializer.new(self).to_xml_params
39
+ end
40
+ end
41
+ end
@@ -0,0 +1,34 @@
1
+ module PagSeguro
2
+ class SubscriptionDiscount
3
+ class RequestSerializer
4
+ attr_reader :object
5
+
6
+ def initialize(object)
7
+ @object = object
8
+ end
9
+
10
+ def to_xml_params
11
+ xml_builder.to_xml(
12
+ save_with:
13
+ Nokogiri::XML::Node::SaveOptions::NO_EMPTY_TAGS |
14
+ Nokogiri::XML::Node::SaveOptions::FORMAT
15
+ )
16
+ end
17
+
18
+ private
19
+
20
+ def to_amount(amount)
21
+ "%.2f" % BigDecimal(amount.to_s).round(2).to_s("F") if amount
22
+ end
23
+
24
+ def xml_builder
25
+ Nokogiri::XML::Builder.new(encoding: PagSeguro.encoding) do |xml|
26
+ xml.send(:directPreApproval) {
27
+ xml.send(:type, object.type)
28
+ xml.send(:value, to_amount(object.value))
29
+ }
30
+ end
31
+ end
32
+ end
33
+ end
34
+ end
@@ -0,0 +1,34 @@
1
+ module PagSeguro
2
+ class SubscriptionDiscount
3
+ class Response
4
+ # The http response.
5
+ attr_reader :response
6
+
7
+ # Set the object that will receive errors or updates
8
+ attr_reader :object
9
+
10
+ def initialize(response, object)
11
+ @response = response
12
+ @object = object
13
+ end
14
+
15
+ def serialize
16
+ unless success?
17
+ object.errors.add response
18
+ end
19
+
20
+ object
21
+ end
22
+
23
+ def success?
24
+ response.success? && response.xml?
25
+ end
26
+
27
+ private
28
+
29
+ def xml
30
+ Nokogiri::XML(response.body)
31
+ end
32
+ end
33
+ end
34
+ end
@@ -0,0 +1,21 @@
1
+ module PagSeguro
2
+ class SubscriptionPaymentMethod
3
+ include Extensions::MassAssignment
4
+ include Extensions::EnsureType
5
+
6
+ # Set the token
7
+ attr_accessor :token
8
+
9
+ # Get the holder
10
+ attr_reader :holder
11
+
12
+ # Set the holder
13
+ def holder=(holder)
14
+ @holder = ensure_type(PagSeguro::Holder, holder)
15
+ end
16
+
17
+ def type
18
+ 'CREDITCARD'
19
+ end
20
+ end
21
+ end
@@ -0,0 +1,57 @@
1
+ module PagSeguro
2
+ class SubscriptionPaymentOrder
3
+ include Extensions::MassAssignment
4
+ include Extensions::EnsureType
5
+
6
+ STATUSES = {
7
+ scheduled: 1,
8
+ processing: 2,
9
+ not_processed: 3,
10
+ suspended: 4,
11
+ paid: 5,
12
+ not_paid: 6
13
+ }
14
+
15
+ attr_accessor :errors
16
+
17
+ attr_accessor :code
18
+ attr_accessor :status
19
+ attr_accessor :amount
20
+ attr_accessor :gross_amount
21
+ attr_accessor :last_event_date
22
+ attr_accessor :scheduling_date
23
+ attr_reader :discount
24
+
25
+ def discount=(discount)
26
+ @discount = ensure_type(PagSeguro::SubscriptionDiscount, discount)
27
+ end
28
+
29
+ def transactions
30
+ @transactions ||= SubscriptionTransactions.new
31
+ end
32
+
33
+ def transactions=(attrs)
34
+ attrs.each do |params|
35
+ transactions << SubscriptionTransaction.new(params)
36
+ end
37
+ end
38
+
39
+ def status_code
40
+ STATUSES[@status.to_sym]
41
+ end
42
+
43
+ def update_attributes(attrs)
44
+ attrs.each {|name, value| send("#{name}=", value) }
45
+ end
46
+
47
+ def self.load_from_xml(xml)
48
+ new ResponseSerializer.new(xml).serialize
49
+ end
50
+
51
+ private
52
+
53
+ def after_initialize
54
+ @errors ||= Errors.new
55
+ end
56
+ end
57
+ end
@@ -0,0 +1,37 @@
1
+ module PagSeguro
2
+ class SubscriptionPaymentOrder
3
+ class Response
4
+ def initialize(response, object)
5
+ @response = response
6
+ @object = object
7
+ end
8
+
9
+ def serialize
10
+ if success?
11
+ object.update_attributes serialized_data
12
+ else
13
+ object.errors.add response
14
+ end
15
+
16
+ object
17
+ end
18
+
19
+ def success?
20
+ response.success? && response.xml?
21
+ end
22
+
23
+ private
24
+
25
+ attr_reader :response
26
+ attr_reader :object
27
+
28
+ def serialized_data
29
+ ResponseSerializer.new(xml).serialize
30
+ end
31
+
32
+ def xml
33
+ Nokogiri::XML(response.data)
34
+ end
35
+ end
36
+ end
37
+ end
@@ -0,0 +1,51 @@
1
+ module PagSeguro
2
+ class SubscriptionPaymentOrder
3
+ class ResponseSerializer
4
+ attr_reader :xml
5
+
6
+ def initialize(xml)
7
+ @xml = xml
8
+ end
9
+
10
+ def serialize
11
+ {}.tap do |data|
12
+ data[:code] = xml.at_css('code').text
13
+ data[:status] = SubscriptionPaymentOrder::STATUSES.key(xml.at_css('status').text.to_i)
14
+ data[:amount] = to_amount xml.at_css('amount').text
15
+ data[:gross_amount] = xml.at_css('grossAmount').text
16
+ data[:scheduling_date] = Time.parse(xml.css('schedulingDate').text)
17
+ data[:last_event_date] = Time.parse(xml.css('lastEventDate').text)
18
+ data[:discount] = serialize_discount if xml.at_css('discount')
19
+ data[:transactions] = serialize_transactions if xml.css('transactions').any?
20
+ end
21
+ end
22
+
23
+ private
24
+
25
+ def serialize_discount
26
+ {}.tap do |data|
27
+ data[:type] = xml.css('discount > type').text
28
+ data[:value] = xml.css('discount > value').text
29
+ end
30
+ end
31
+
32
+ def serialize_transactions
33
+ xml.css('transactions').map do |node|
34
+ serialize_transaction(node)
35
+ end
36
+ end
37
+
38
+ def serialize_transaction(node)
39
+ {}.tap do |data|
40
+ data[:code] = node.css('> code').text
41
+ data[:date] = Time.parse(node.css('> date').text)
42
+ data[:status] = SubscriptionTransaction::STATUSES.key(node.css('> status').text.to_i)
43
+ end
44
+ end
45
+
46
+ def to_amount(amount)
47
+ "%.2f" % BigDecimal(amount.to_s).round(2).to_s("F") if amount
48
+ end
49
+ end
50
+ end
51
+ end
@@ -0,0 +1,69 @@
1
+ module PagSeguro
2
+ class SubscriptionPlan
3
+ API_VERSION = 'v2'
4
+
5
+ include Extensions::MassAssignment
6
+ include Extensions::Credentiable
7
+ include Extensions::EnsureType
8
+
9
+ attr_accessor :max_users
10
+ attr_accessor :name
11
+ attr_accessor :charge
12
+ attr_accessor :period
13
+ attr_accessor :amount
14
+ attr_accessor :max_total_amount
15
+ attr_accessor :max_amount_per_period
16
+ attr_accessor :max_payments_per_period
17
+ attr_accessor :max_amount_per_payment
18
+ attr_accessor :final_date
19
+ attr_accessor :initial_date
20
+ attr_accessor :membership_fee
21
+ attr_accessor :trial_duration
22
+ attr_accessor :code
23
+ attr_accessor :reference
24
+ attr_accessor :redirect_url
25
+ attr_accessor :review_url
26
+ attr_accessor :details
27
+
28
+ attr_reader :sender
29
+
30
+ # Set errors
31
+ def errors
32
+ @errors ||= Errors.new
33
+ end
34
+
35
+ # Update all attributes
36
+ def update_attributes(attrs)
37
+ attrs.each { |name, value| send("#{name}=", value) }
38
+ end
39
+
40
+ # Set sender
41
+ def sender=(sender)
42
+ @sender = ensure_type(Sender, sender)
43
+ end
44
+
45
+ def create
46
+ request = Request.post_xml('pre-approvals/request', API_VERSION, credentials, xml_params)
47
+
48
+ Response.new(request, self).serialize
49
+
50
+ self
51
+ end
52
+
53
+ def url
54
+ return unless code
55
+
56
+ "#{PagSeguro.uris[PagSeguro.environment][:site]}v2/pre-approvals/request.html?code=#{code}"
57
+ end
58
+
59
+ private
60
+
61
+ def xml_params
62
+ RequestSerializer.new(self).to_xml_params
63
+ end
64
+
65
+ def after_initialize
66
+ @errors = Errors.new
67
+ end
68
+ end
69
+ end
@@ -0,0 +1,81 @@
1
+ module PagSeguro
2
+ class SubscriptionPlan
3
+ class RequestSerializer
4
+ attr_reader :object
5
+
6
+ def initialize(object)
7
+ @object = object
8
+ end
9
+
10
+ def to_xml_params
11
+ xml_builder.to_xml(
12
+ save_with:
13
+ Nokogiri::XML::Node::SaveOptions::NO_EMPTY_TAGS |
14
+ Nokogiri::XML::Node::SaveOptions::FORMAT
15
+ )
16
+ end
17
+
18
+ private
19
+
20
+ def to_amount(amount)
21
+ "%.2f" % BigDecimal(amount.to_s).round(2).to_s("F") if amount
22
+ end
23
+
24
+ def xml_serialize_sender(xml)
25
+ return unless object.sender
26
+
27
+ xml.send(:sender) {
28
+ xml.send(:name, object.sender.name)
29
+ xml.send(:email, object.sender.email)
30
+ if object.sender.phone
31
+ xml.send(:phone) {
32
+ xml.send(:areaCode, object.sender.phone.area_code)
33
+ xml.send(:number, object.sender.phone.number)
34
+ }
35
+ end
36
+
37
+ if object.sender.address
38
+ xml.send(:address) {
39
+ xml.send(:street, object.sender.address.street)
40
+ xml.send(:number, object.sender.address.number)
41
+ xml.send(:complement, object.sender.address.complement)
42
+ xml.send(:district, object.sender.address.district)
43
+ xml.send(:postalCode, object.sender.address.postal_code)
44
+ xml.send(:city, object.sender.address.city)
45
+ xml.send(:state, object.sender.address.state)
46
+ xml.send(:country, object.sender.address.country)
47
+ }
48
+ end
49
+ }
50
+ end
51
+
52
+ def xml_builder
53
+ Nokogiri::XML::Builder.new(encoding: PagSeguro.encoding) do |xml|
54
+ xml.send(:preApprovalRequest) {
55
+ xml.send(:redirectURL, object.redirect_url)
56
+ xml.send(:reviewURL, object.review_url)
57
+ xml.send(:reference, object.reference)
58
+ xml.send(:maxUsers, object.max_users)
59
+ xml_serialize_sender(xml)
60
+
61
+ xml.send(:preApproval) {
62
+ xml.send(:name, object.name)
63
+ xml.send(:details, object.details)
64
+ xml.send(:charge, object.charge)
65
+ xml.send(:period, object.period)
66
+ xml.send(:amountPerPayment, to_amount(object.amount))
67
+ xml.send(:maxTotalAmount, to_amount(object.max_total_amount))
68
+ xml.send(:maxPaymentsPerPeriod, object.max_payments_per_period.to_i) if object.max_payments_per_period
69
+ xml.send(:maxAmountPerPeriod, to_amount(object.max_amount_per_period))
70
+ xml.send(:maxAmountPerPayment, to_amount(object.max_amount_per_payment))
71
+ xml.send(:finalDate, object.final_date.xmlschema) if object.final_date
72
+ xml.send(:initialDate, object.initial_date.xmlschema) if object.initial_date
73
+ xml.send(:membershipFee, to_amount(object.membership_fee))
74
+ xml.send(:trialPeriodDuration, object.trial_duration.to_i)
75
+ }
76
+ }
77
+ end
78
+ end
79
+ end
80
+ end
81
+ end
@@ -0,0 +1,36 @@
1
+ module PagSeguro
2
+ class SubscriptionPlan
3
+ class Response
4
+ # The http response.
5
+ attr_reader :response
6
+
7
+ # Set the boject that will receive errors or updates
8
+ attr_reader :object
9
+
10
+ def initialize(response, object)
11
+ @response = response
12
+ @object = object
13
+ end
14
+
15
+ def serialize
16
+ if success?
17
+ object.update_attributes(ResponseSerializer.new(xml).serialize)
18
+ else
19
+ object.errors.add response
20
+ end
21
+
22
+ object
23
+ end
24
+
25
+ def success?
26
+ response.success? && response.xml?
27
+ end
28
+
29
+ private
30
+
31
+ def xml
32
+ Nokogiri::XML(response.body)
33
+ end
34
+ end
35
+ end
36
+ end