The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Net::Iugu - Perl modules for integration with Iugu payment web services

VERSION

version 0.000001

SYNOPSIS

Implements the API calls to Iugu payment services.

    use Net::Iugu;

    my $api = Net::Iugu->new( token => 'my_api_token' );

    my $res;

    $res = $api->customers->create( $data );
    $res = $api->customers->read( $customer_id );
    $res = $api->customers->update( $customer_id, $data );
    $res = $api->customers->delete( $customer_id );
    $res = $api->customers->list( $params );
    
    $res = $api->payment_methods->create( $data );
    $res = $api->payment_methods->read(   $customer_id, $method_id );
    $res = $api->payment_methods->update( $customer_id, $method_id, $data );
    $res = $api->payment_methods->delete( $customer_id, $method_id );
    $res = $api->payment_methods->list( $params );

    $res = $api->invoices->create( $data );
    $res = $api->invoices->read( $invoice_id );
    $res = $api->invoices->update( $invoice_id, $data );
    $res = $api->invoices->delete( $invoice_id );
    $res = $api->invoices->cancel( $invoice_id );
    $res = $api->invoices->refund( $invoice_id );
    $res = $api->invoices->list( $params );

    $res = $api->market_place->create_account( $data );
    $res = $api->market_place->request_account_verification( $user_token, $account_id, $data );
    $res = $api->market_place->account_info( $account_id );
    $res = $api->market_place->configurate_account( $user_token, $data );
    $res = $api->market_place->request_withdraw( $account_id, $amount );
   
    $res = $api->plans->create( $data );
    $res = $api->plans->read( $plan_id );
    $res = $api->plans->read_by_identifier( $plan_id );
    $res = $api->plans->update( $plan_id, $data );
    $res = $api->plans->delete( $plan_id );
    $res = $api->plans->list( $params );

    $res = $api->subscriptions->create( $data );
    $res = $api->subscriptions->read( $subscription_id );
    $res = $api->subscriptions->update( $subscription_id, $data );
    $res = $api->subscriptions->delete( $subscription_id );
    $res = $api->subscriptions->list( $params );
    $res = $api->subscriptions->suspend( $subscription_id );
    $res = $api->subscriptions->activate( $subscription_id );
    $res = $api->subscriptions->change_plan( $subscription_id, $plan_id );
    $res = $api->subscriptions->add_credits( $subscription_id, $amount );
    $res = $api->subscriptions->remove_credits( $subscription_id, $amount );

    $res = $api->transfers->transfer( $data );
    $res = $api->transfers->list;

    $res = $api->create_token( $data );
    $res = $api->charge( $data );

For a detailed reference of params and return values check the Official Documentation.

For a detailed reference of params and return values of methods create_token and c<charge> check the documentation of them.

Aditionally, check the document of each auxiliar module: Net::Iugu::Customers, Net::Iugu::PaymentMethods, Net::Iugu::Invoices, Net::Iugu::MarketPlace, Net::Iugu::Plans, Net::Iugu::Subscriptions and Net::Iugu::Transfers.

METHODS

create_token( $data )

Creates a payment token for use with direct charges.

charge( $data )

Charges directly the credit card of a client or generates a bank slip.

AUTHOR

Blabos de Blebe <blabos@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Blabos de Blebe.

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