Class: Lago::Api::Resources::Invoice

Inherits:
Base
  • Object
show all
Defined in:
lib/lago/api/resources/invoice.rb

Instance Attribute Summary

Attributes inherited from Base

#client

Instance Method Summary collapse

Methods inherited from Base

#destroy, #get, #get_all, #initialize, #update

Constructor Details

This class inherits a constructor from Lago::Api::Resources::Base

Instance Method Details

#api_resource ⇒ Object 



7
8
9
 
# File 'lib/lago/api/resources/invoice.rb', line 7

def api_resource
  'invoices'
end

#create(params) ⇒ Object 



15
16
17
18
19
20
 
# File 'lib/lago/api/resources/invoice.rb', line 15

def create(params)
  payload = one_off_params(params)
  response = connection.post(payload)[root_name]

  JSON.parse(response.to_json, object_class: OpenStruct)
end

#download(invoice_id) ⇒ Object 



22
23
24
25
26
27
 
# File 'lib/lago/api/resources/invoice.rb', line 22

def download(invoice_id)
  path = "/api/v1/invoices/#{invoice_id}/download"
  response = connection.post({}, path)

  JSON.parse(response.to_json, object_class: OpenStruct).invoice
end

#finalize(invoice_id) ⇒ Object 



36
37
38
39
40
41
 
# File 'lib/lago/api/resources/invoice.rb', line 36

def finalize(invoice_id)
  path = "/api/v1/invoices/#{invoice_id}/finalize"
  response = connection.put(path, identifier: nil, body: {})

  JSON.parse(response.to_json, object_class: OpenStruct).invoice
end

#one_off_params(params) ⇒ Object 



73
74
75
76
77
78
79
80
81
82
83
 
# File 'lib/lago/api/resources/invoice.rb', line 73

def one_off_params(params)
  result = {
    external_customer_id: params[:external_customer_id],
    currency: params[:currency],
  }

  fees = whitelist_fees(params[:fees])
  result[:fees] = fees unless fees.empty?

  { root_name => result }
end

#refresh(invoice_id) ⇒ Object 



29
30
31
32
33
34
 
# File 'lib/lago/api/resources/invoice.rb', line 29

def refresh(invoice_id)
  path = "/api/v1/invoices/#{invoice_id}/refresh"
  response = connection.put(path, identifier: nil, body: {})

  JSON.parse(response.to_json, object_class: OpenStruct).invoice
end

#retry_payment(invoice_id) ⇒ Object 



43
44
45
46
47
48
 
# File 'lib/lago/api/resources/invoice.rb', line 43

def retry_payment(invoice_id)
  path = "/api/v1/invoices/#{invoice_id}/retry_payment"
  response = connection.post({}, path)

  JSON.parse(response.to_json, object_class: OpenStruct)
end

#root_name ⇒ Object 



11
12
13
 
# File 'lib/lago/api/resources/invoice.rb', line 11

def root_name
  'invoice'
end

#whitelist_fees(fees) ⇒ Object 



85
86
87
88
89
90
91
92
93
94
95
 
# File 'lib/lago/api/resources/invoice.rb', line 85

def whitelist_fees(fees)
  processed_fees = []

  fees.each do |f|
    result = (f || {}).slice(:add_on_code, :unit_amount_cents, :units, :description)

    processed_fees << result unless result.empty?
  end

  processed_fees
end

#whitelist_metadata(metadata) ⇒ Object 



61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/lago/api/resources/invoice.rb', line 61

def whitelist_metadata(metadata)
  processed_metadata = []

  metadata.each do |m|
    result = (m || {}).slice(:id, :key, :value)

    processed_metadata << result unless result.empty?
  end

  processed_metadata
end

#whitelist_params(params) ⇒ Object 



50
51
52
53
54
55
56
57
58
59
 
# File 'lib/lago/api/resources/invoice.rb', line 50

def whitelist_params(params)
  result = {
    payment_status: params[:payment_status],
  }

  metadata = whitelist_metadata(params[:metadata])
  result[:metadata] = metadata unless metadata.empty?

  { root_name => result }
end