Sha256: bdead839bb3495013e61bd20ba6d9d1250ee1df9393eb5f27ee950e5af9abba1
Contents?: true
Size: 1.81 KB
Versions: 14
Compression:
Stored size: 1.81 KB
Contents
module Balanced
# A Hold is a reservation of funds on a funding source such as a Card. This
# reservation is guaranteed until the +expires_at+ date. You may capture
# the Hold at any time before then which will create a Debit and transfer
# the funds to your Marketplace. If you do not capture the Hold it will
# be marked as invalid which is represented by the +is_void+ field being
# set to +true+.
#
# By default a Hold is created using the most recently added funding source
# on the Account. You may specify a specific funding source such as a Card
# or BankAccount uri.
#
class Hold
include Balanced::Resource
def initialize attributes = {}
Balanced::Utils.stringify_keys! attributes
unless attributes.has_key? 'uri'
attributes['uri'] = self.class.uri
end
super attributes
end
# Cancels an active Hold.
#
def void
self.is_void = true
begin
save
rescue Balanced::Error
self.is_void = false
raise
end
end
# Captures a valid Hold and returns a Debit representing the transfer of
# funds from the buyer's Account to your Marketplace.
#
# @return [Debit]
def capture *args
warn_on_positional args
options = args.last.is_a?(Hash) ? args.pop : {}
amount = args[0] || options.fetch(:amount) { nil }
appears_on_statement_as = args[1] || options.fetch(:appears_on_statement_as) { nil }
meta = args[2] || options.fetch(:meta) { nil }
description = args[3] || options.fetch(:description) { nil }
amount ||= self.amount
self.account.debit(
:amount => amount,
:appears_on_statement_as => appears_on_statement_as,
:hold_uri => self.uri,
:meta => meta,
:description => description
)
end
end
end
Version data entries
14 entries across 14 versions & 1 rubygems