iugu-meteor

This package provide (server side) integration with the Iugu payment API (brazilian payment gateway) No client side support added.

The oficial iugu documentation can be found here https://iugu.com/referencias/api

Please read everything bellow before you start to using it

Resources in this package

The package supports the methods bellow:

Customers

create_customer
update_customer
customers (list)
get_customer
remove_customer

Payment methods

create_payment_method
payment_methods (list)
get_payment_method
update_payment_method
remove_payment_method

Invoices

create_invoice
get_invoice
cancel_invoice
remove_invoice
invoices (list)
refund_invoice

Plans

create_plan
update_plan
get_plan
get_plan_by_identifier
remove_plan
plans (list)

Subscriptions

create_subscription
update_subscription
remove_subscription
suspend_subscription
activate_subscription
change_subscription_plan
subscription_add_credits
subscription_remove_credits
subscriptions
get_subscription

Charge and Bank Slip

charge
charge_bank_slip

Testing installing the package with meteor add

Setup the startup configuration with your api key

Use the test key first

Meteor.startup(function(){
  //Put your IUGU token bellow - Use the test KEY for tests
  IugiApi = new Iugu.API("YOUR API KEY HERE");
});

To use it just create Meteor methods and call the api

Meteor.methods({
  'iugu.listCustomers': function() {
    var customers = IugiApi.customers()
    return clientes;
});

Testing cloning the package

If you are cloning this repository you can run the tests directly on this package using meteor change the configuration on

iugu\tests\0-config-api.js

TEST_DATA = {
  email: "youremail",
  test_token: "YOUR TEST TOKEN",
  due_date: "18/08/2015",
  /* timeout to procede so you can see the feature on iugu's website,
   look the console to know when you need to look the site, set 0 if you don't want to check.
  */
  wait_me_time: 0 //put something between 40000 (40seg) and 60000 (1 minute)
};

The test directory contains examples of how to call each method on the api You can comment any test files from 1 to 5 in the package.js file To test the package run the command bellow and go to localhost:3000

cd iugu
meteor test-packages ./

Not supported yet

A few resources are not supported yet

Transfers
Marketplace

Webhooks (Gatilhos)

After a invoice is marked as paid or any other action, iugu can call a url from your website, you can configure this url on https://iugu.com/a/webhooks you need to put a published url localhost will not work.

I suggest you create a collection to insert the returned data to check it later

//lib directory (client and server)
Iugu = new Mongo.Collection("iugu");

To create a URL you can either use Ironrouter if your are used to it

//server
Router.onBeforeAction(Iron.Router.bodyParser.urlencoded({
  extended: false
}));

Router.route('/api/retorno', function() {
  body = this.request.body;
  Iugu.insert(body);
  this.response.end("OK");
}, {
  where: 'server'
})

or you can use the JsonRoutes packages (meteor add simple:json-routes) I am using it since I am using angular and Ironrouter conflicted with ui-router.

//server
JsonRoutes.add("post", "/api/retorno", function(req, res, next) {
  Iugu.insert(req.body);
  JsonRoutes.sendResult(res, 200, req.body);
});

Save your URl on iugu webhooks ex: http://yoursite.com/api/retorno and check the collections after your tests

mariotoledo / iugu-meteor