Class: GoCardlessPro::Resources::Block

Inherits:
Object
  • Object
show all
Defined in:
lib/gocardless_pro/resources/block.rb

Overview

Blocks are created to prevent certain customer details from being used when creating mandates.

The details used to create blocks can be exact matches, like a bank account or an email, or a more generic match such as an email domain or bank name. Please be careful when creating blocks for more generic matches as this may block legitimate payers from using your service.

New block types may be added over time.

A block is in essence a simple rule that is used to match against details in a newly created mandate. If there is a successful match then the mandate is transitioned to a “blocked” state.

Please note:

- Payments and subscriptions cannot be created against a mandate in

blocked state.

- A mandate can never be transitioned out of the blocked state.

The one exception to this is when blocking a ‘bank_name’. This block will prevent bank accounts from being created for banks that match the given name. To ensure we match bank names correctly an existing bank account must be used when creating this block. Please be aware that we cannot always match a bank account to a given bank name.

<p class=“notice”>

This API is currently only available for GoCardless Protect+ integrators

would like to use this API. </p>

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(object, response = nil) ⇒ Block

Initialize a block resource instance

Parameters:

  • object (Hash) —

    an object returned from the API



57
58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/gocardless_pro/resources/block.rb', line 57

def initialize(object, response = nil)
  @object = object

  @active = object['active']
  @block_type = object['block_type']
  @created_at = object['created_at']
  @id = object['id']
  @reason_description = object['reason_description']
  @reason_type = object['reason_type']
  @resource_reference = object['resource_reference']
  @updated_at = object['updated_at']
  @response = response
end

Instance Attribute Details

#active ⇒ Object (readonly)

Returns the value of attribute active.



52
53
54
 
# File 'lib/gocardless_pro/resources/block.rb', line 52

def active
  @active
end

#block_type ⇒ Object (readonly)

Returns the value of attribute block_type.



52
53
54
 
# File 'lib/gocardless_pro/resources/block.rb', line 52

def block_type
  @block_type
end

#created_at ⇒ Object (readonly)

Returns the value of attribute created_at.



52
53
54
 
# File 'lib/gocardless_pro/resources/block.rb', line 52

def created_at
  @created_at
end

#id ⇒ Object (readonly)

Returns the value of attribute id.



52
53
54
 
# File 'lib/gocardless_pro/resources/block.rb', line 52

def id
  @id
end

#reason_description ⇒ Object (readonly)

Returns the value of attribute reason_description.



52
53
54
 
# File 'lib/gocardless_pro/resources/block.rb', line 52

def reason_description
  @reason_description
end

#reason_type ⇒ Object (readonly)

Returns the value of attribute reason_type.



52
53
54
 
# File 'lib/gocardless_pro/resources/block.rb', line 52

def reason_type
  @reason_type
end

#resource_reference ⇒ Object (readonly)

Returns the value of attribute resource_reference.



52
53
54
 
# File 'lib/gocardless_pro/resources/block.rb', line 52

def resource_reference
  @resource_reference
end

#updated_at ⇒ Object (readonly)

Returns the value of attribute updated_at.



52
53
54
 
# File 'lib/gocardless_pro/resources/block.rb', line 52

def updated_at
  @updated_at
end

Instance Method Details

#api_response ⇒ Object 



71
72
73
 
# File 'lib/gocardless_pro/resources/block.rb', line 71

def api_response
  ApiResponse.new(@response)
end

#to_h ⇒ Object

Provides the block resource as a hash of all its readable attributes



76
77
78
 
# File 'lib/gocardless_pro/resources/block.rb', line 76

def to_h
  @object
end