Class: Stripe::PromotionCodeService

Inherits:
StripeService show all
Defined in:
lib/stripe/services/promotion_code_service.rb

Instance Method Summary collapse

Methods inherited from StripeService

#initialize, #request, #request_stream

Constructor Details

This class inherits a constructor from Stripe::StripeService

Instance Method Details

#create(params = {}, opts = {}) ⇒ Object

A promotion code points to a coupon. You can optionally restrict the code to a specific customer, redemption limit, and expiration date.



7
8
9
10
11
12
13
14
15
# File 'lib/stripe/services/promotion_code_service.rb', line 7

def create(params = {}, opts = {})
  request(
    method: :post,
    path: "/v1/promotion_codes",
    params: params,
    opts: opts,
    base_address: :api
  )
end

#list(params = {}, opts = {}) ⇒ Object

Returns a list of your promotion codes.



18
19
20
21
22
23
24
25
26
# File 'lib/stripe/services/promotion_code_service.rb', line 18

def list(params = {}, opts = {})
  request(
    method: :get,
    path: "/v1/promotion_codes",
    params: params,
    opts: opts,
    base_address: :api
  )
end

#retrieve(promotion_code, params = {}, opts = {}) ⇒ Object

Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing code use [list](stripe.com/docs/api/promotion_codes/list) with the desired code.



29
30
31
32
33
34
35
36
37
# File 'lib/stripe/services/promotion_code_service.rb', line 29

def retrieve(promotion_code, params = {}, opts = {})
  request(
    method: :get,
    path: format("/v1/promotion_codes/%<promotion_code>s", { promotion_code: CGI.escape(promotion_code) }),
    params: params,
    opts: opts,
    base_address: :api
  )
end

#update(promotion_code, params = {}, opts = {}) ⇒ Object

Updates the specified promotion code by setting the values of the parameters passed. Most fields are, by design, not editable.



40
41
42
43
44
45
46
47
48
# File 'lib/stripe/services/promotion_code_service.rb', line 40

def update(promotion_code, params = {}, opts = {})
  request(
    method: :post,
    path: format("/v1/promotion_codes/%<promotion_code>s", { promotion_code: CGI.escape(promotion_code) }),
    params: params,
    opts: opts,
    base_address: :api
  )
end