NAME

Business::CPI::Role::Receiver - The person receiving the money

VERSION

version 0.922

SYNOPSIS

# when building a cart
my $cart = $cpi->new_cart({
    ...
    receivers => [
        {
            # alias for account.gateway_id
            gateway_id      => 2313,

            fixed_amount    => 50.00,
            percent_amount  => 5.00,
            pay_gateway_fee => 1,
        },
        {
            account         => $cpi->account_class->new({ ... }),
            fixed_amount    => 250.00,
            pay_gateway_fee => 0,
        },
    ],
});

DESCRIPTION

This role is meant to be included by the class which represents Receivers in the gateway, such as Business::CPI::Base::Receiver. A Receiver is an account in the gateway which is going to receive a percentage or fixed amount of the payment being made.

ATTRIBUTES

account

MANDATORY. A representation of the user account in the gateway. See the Account role for details.

gateway_id (shortcut)

This is not really an attribute, but a shortcut to the gateway_id attribute in the Account. You should provide either a gateway_id or an Account object (for the account attribute) when instantiating a Receiver object, but never both.

is_primary

Boolean. Is this the main account receiving the money, or secondary? Defaults to false, i.e., it's a secondary receiver.

pay_gateway_fee

Boolean attribute to define whether this receiver should be the one paying the gateway fees. Similar to the "feesPayer" parameter in Adaptive Payments in PayPal.

gateway_fee

The fee amount this receiver was charged by the gateway.

fixed_amount

The value, in the chosen currency, this receiver is getting of the payment.

percentual_amount

The percentage of the payment that this receiver is getting.

AUTHOR

André Walker <andre@andrewalker.net>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by André Walker.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.