README.md in mundipagg_api-1.0.0 vs README.md in mundipagg_api-1.0.1
- old
+ new
@@ -1,7 +1,20 @@
# mundipagg-one-ruby
+### Mundipagg Gem Download
+https://rubygems.org/gems/mundipagg_api
+
+```ruby
+$ gem install mundipagg_api
+```
+
+```ruby
+require 'mundipagg_api'
+```
+
+Ruby DevKit is required.
+
### About Windows
The recommended Windows version of Ruby is Ruby 2.1.
For gems work correctly it'll be necessary run the following commands:
No Windows a versão do Ruby recomendada é a 2.1.
@@ -17,45 +30,55 @@
$ gem install rspec
$ gem install nori
$ gem install gyoku
$ gem install nokogiri
$ gem install ffi
+$ gem install bundler
```
### Bundler
Run the following commands to install gems:
Rode os seguintes comandos para instalar as gems:
```ruby
$ gem install bundler
$ bundle install
```
-Running tests:
+Running tests with `bundle exec`:
-Rodando testes:
+Rodando testes com `bundle exec`:
```ruby
$ bundle exec rspec spec/integration/gateway_spec.rb
```
+Running tests with `rake`:
+
+Rodando testes com `rake`:
+
+```ruby
+$ rake
+```
+
## Code Examples
### Create a Credit Card Transaction
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
# passa a merchantKey na variável
merchantKey = 'sua merchantKey'
# instancia classe com métodos de requisição
# :staging ou nada para ambiente sandbox e :production para ambiente de produção
-gateway = Gateway.new(:production, merchantKey)
+gateway = MundipaggApi.new(:production, merchantKey)
# coleta dados do cartão
creditCardTransaction = CreditCardTransaction.new
creditCardTransaction.AmountInCents = 100
creditCardTransaction.InstallmentCount = 1
creditCardTransaction.TransactionReference = 'CreditCard One RubySDK Test'
+creditCardTransaction.CreditCardOperation = 'AuthOnly'
creditCardTransaction.Options.PaymentMethodCode = 1
creditCardTransaction.Options.SoftDescriptorText = 'My Store Name'
creditCardTransaction.CreditCard.CreditCardNumber = '5453010000066167'
creditCardTransaction.CreditCard.ExpMonth = 5
creditCardTransaction.CreditCard.ExpYear = 18
@@ -72,18 +95,18 @@
```
### Create a BoletoTransaction
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
# passa a merchantKey na variável
merchantKey = 'sua merchantKey'
# instancia classe com métodos de requisição
# :staging ou nada para ambiente sandbox e :production para ambiente de produção
-gateway = Gateway.new(:production, merchantKey)
+gateway = MundipaggApi.new(:production, merchantKey)
# instancia um objeto de transação de boleto
boletoTransaction = BoletoTransaction.new
boletoTransaction.AmountInCents = 100
boletoTransaction.BankNumber = '237'
@@ -104,17 +127,17 @@
```
### Cancel Method
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
merchantKey = 'Sua Merchant Key'
# instancia classe com métodos de requisição
# :staging para ambiente sandbox e :production para ambiente de produção
-gateway = Gateway.new(:staging, merchantKey)
+gateway = MundipaggApi.new(:staging, merchantKey)
# preenche um item de colecao, necessario para cancelamento da transacao de cartao de credito
cancelCreditCardTransactionItem = ManageCreditCardTransaction.new
cancelCreditCardTransactionItem.AmountInCents = 100
cancelCreditCardTransactionItem.TransactionKey = 'TransactionKey da transação'
@@ -123,28 +146,25 @@
# monta o objeto para cancelamento de transação
cancelSaleRequest = ManageSaleRequest.new
cancelSaleRequest.OrderKey = 'OrderKey AQUI'
cancelSaleRequest.CreditCardTransactionCollection << cancelCreditCardTransactionItem
-# incrementa na coleção o item de retry
-retrySaleRequest.RetrySaleCreditCardTransactionCollection << retrySaleCreditCardTransactionItem
-
# faz a requisição de cancelamento, retorna um hash com a resposta
response = gateway.Cancel(cancelSaleRequest)
```
### Capture Method
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
# merchant key
merchantKey = 'sua merchantKey'
# inicializa a classe com métodos de requisição
# :staging ou nada para ambiente de sandbox e :production para ambiente de produção
-gateway = Gateway.new(merchantKey)
+gateway = MundipaggApi.new(merchantKey)
# itens necessários para captura da transacão
captureCreditCardTransactionItem = ManageCreditCardTransaction.new
captureCreditCardTransactionItem.AmountInCents = 100
captureCreditCardTransactionItem.TransactionKey = 'transactionKey da transação'
@@ -162,17 +182,17 @@
```
### Retry Method
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
merchantKey = 'Sua Merchant Key'
# instancia classe com métodos de requisição
# :staging para ambiente sandbox e :production para ambiente de produção
-gateway = Gateway.new(:staging, merchantKey)
+gateway = MundipaggApi.new(:staging, merchantKey)
retrySaleRequest = RetrySaleRequest.new
retrySaleCreditCardTransactionItem = RetrySaleCreditCardTransaction.new
# preenche um item de coleção
@@ -190,18 +210,18 @@
```
### Query Method
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
# merchant key
merchantKey = 'sua merchantKey'
# inicializa a classe com métodos de requisição
# :staging ou nada para ambiente de sandbox e :production para ambiente de produção
-gateway = Gateway.new(merchantKey)
+gateway = MundipaggApi.new(merchantKey)
# inicializa a QuerySaleRequest
querySaleRequest = QuerySaleRequest.new
# preenche o campo de OrderKey para enviar um request de OrderKey
@@ -223,36 +243,36 @@
The ParseXmlToNotification takes an XML and convert it to a hash variable.
O ParseXmlToNotification converte um XML para uma variável hash.
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
# merchant key
merchantKey = 'sua merchantKey'
# inicializa a classe com métodos de requisição
# :staging ou nada para ambiente de sandbox e :production para ambiente de produção
-gateway = Gateway.new(merchantKey)
+gateway = MundipaggApi.new(merchantKey)
xml = 'xml que será passsado na variável'
# faz a requisição de PostNotification (parse do XML) e retorna um hash do XML passado
response = gateway.ParseXmlToNotification(xml)
```
### TransactionReportFile Method
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
# merchant key
merchantKey = 'sua merchantKey'
# inicializa a classe com métodos de requisição
# :staging ou nada para ambiente de sandbox e :production para ambiente de produção
-gateway = Gateway.new(merchantKey)
+gateway = MundipaggApi.new(merchantKey)
# cria uma variável do tipo Date, passando apenas o ano, mês e dia (nessa ordem)
date = Date.new(2014, 12, 10)
# faz a requisição do TransactionReportFile e retorna uma string com os dados do report
@@ -263,18 +283,18 @@
##### TransactionReportFileParser
If you want the string that is received from TransactionReportFile Method to be parsed, there is a method for that.
Este método faz um parse na string recebida do método TransactionReportFile e retorna um hash.
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
# merchant key
merchantKey = 'sua merchantKey'
# inicializa a classe com métodos de requisição
# :staging ou nada para ambiente de sandbox e :production para ambiente de produção
-gateway = Gateway.new(merchantKey)
+gateway = MundipaggApi.new(merchantKey)
# cria uma variável do tipo Date, passando apenas o ano, mês e dia (nessa ordem)
date = Date.new(2014, 12, 10)
# faz a requisição do TransactionReportFile e retorna uma string com os dados do report
@@ -287,17 +307,17 @@
##### TransactionReportFileDownloader
This method download and save the TransactionReportFile to a '.txt' file.
Este método faz o download e salva o TransactionReportFile em um arquivo '.txt' no local indicado.
```ruby
-require_relative '../../lib/mundipagg'
+require 'mundipagg_api'
# merchant key
merchantKey = 'sua merchantKey'
# inicializa a classe com métodos de requisição
# :staging ou nada para ambiente de sandbox e :production para ambiente de produção
-gateway = Gateway.new(merchantKey)
+gateway = MundipaggApi.new(merchantKey)
# cria uma variável do tipo Date, passando apenas o ano, mês e dia (nessa ordem)
date = Date.new(2015, 9, 15)
# faz a requisição do transaction report file e salva no destino passado como parâmetro