MyMoip

MoIP transactions in a gem to call your own.

Provides a implementation of MoIP's transparent checkout.

Planning to use with Rails? Check my_moip-rails.

Contributing to MyMoip

What would you do if you could make your own implementation of MoIP?

Any patch are welcome, even removing extra blank spaces.

1. Open a pull request.
2. Done.

Using

Currently under active development.

Bundler - Gemfile

gem 'mymoip'

Configuration

MyMoip.environment = "production" # "sandbox" by default

MyMoip.sandbox_token    = "your_moip_sandbox_token"
MyMoip.sandbox_key      = "your_moip_sandbox_key"

MyMoip.production_token = "your_moip_production_token"
MyMoip.production_key   = "your_moip_production_key"

First request: what and from who

payer = MyMoip::Payer.new(
  id: "payer_id_defined_by_you",
  name: "Juquinha da Rocha",
  email: "[email protected]",
  address_street: "Felipe Neri",
  address_street_number: "406",
  address_street_extra: "Sala 501",
  address_neighbourhood: "Auxiliadora",
  address_city: "Porto Alegre",
  address_state: "RS",
  address_country: "BRA",
  address_cep: "90440150",
  address_phone: "5130405060"
)

instruction = MyMoip::Instruction.new(
  id: "instruction_id_defined_by_you",
  payment_reason: "Order in Buy Everything Store",
  values: [100.0],
  payer: payer
)

transparent_request = MyMoip::TransparentRequest.new("your_logging_id")
transparent_request.api_call(instruction)

Second request: how

credit_card = MyMoip::CreditCard.new(
  logo: :visa,
  card_number: "4916654211627608",
  expiration_date: "06/15",
  security_code: "000",
  owner_name: "Juquinha da Rocha",
  owner_birthday: Date.new(1984, 11, 3),
  owner_phone: "5130405060",
  owner_cpf: "52211670695"
)

credit_card_payment = MyMoip::CreditCardPayment.new(credit_card, installments: 1)
payment_request = MyMoip::PaymentRequest.new("your_logging_id")
payment_request.api_call(credit_card_payment, token: transparent_request.token)

Success?

payment_request.success?

Sending payments to multiple receivers

Choosing between commission with fixed or percentage value.

commissions = [MyMoip::Commission.new(
  reason: 'System maintenance',
  receiver_login: 'commissioned_moip_login',
  fixed_value: 15.0
)]

# OR

commissions = [MyMoip::Commission.new(
  reason: 'Shipping',
  receiver_login: 'commissioned_moip_login',
  percentage_value: 0.15
)]

instruction = MyMoip::Instruction.new(
  id: "instruction_id_defined_by_you",
  payment_reason: "Order in Buy Everything Store",
  values: [100.0],
  payer: payer,
  commissions: commissions
)

Wiki will be helpful here.

Documentation

For more information about usage you can access the wiki page.

Going alive!

If you are ready to get your application using MyMoip approved by MoIP or already have valid production keys, you can read a specific documentation.

License

MIT. See LICENSE.txt for further details.