moip2 1.2.1 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: c3950765e5a024400c5733ce2359fd79bbec429696dd56d6273729a5a6ef234c
-  data.tar.gz: 2962c0b09e7098b0882b12f37168091c030c5711e5de7987fa1e1d2e8c58ba66
+SHA1:
+  metadata.gz: 9e8a812821aad96dca62b0879d12cd9d980e31fd
+  data.tar.gz: 290160cd134386f6cecb44958931a3cab4e4d7e5
 SHA512:
-  metadata.gz: 5e7e46aa99da3768b4adb297e93516f58b40880e98020fa7d9e7e73fb9141172b0913ce2de0979d15c7033938035ebcce0a1237e6be7124261e4d94b9b2515d1
-  data.tar.gz: 4d9d13afc47ffca7f06c8b6e789a1242741b140038ac6b6d54c03fcea8ce45cffe54af6c0614b8c34043fb4c2376d18545e346840dc210d967c8dd8b550a0a3c
+  metadata.gz: ce8dd6e7ab5d2b9196ec7b43e570fc0154d595ec39987f2d0ade40884aae0dbf90be03c10117ada4d9e3b2ad1417019381f1331329897da199a4e05f5b5bfbfe
+  data.tar.gz: 645180e622c6f8c7fc441ecca446924b845866f0bee060da5f1bf35808ebef47e6747009580bc9fdfa765b4c5f8f3655495bb5894370ed96b961bf8924fe79d7

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    moip2 (1.2.0)
+    moip2 (1.3.0)
       httparty
       recursive-open-struct
 

data/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+## PR Summary
+
+## Detailed description
+  #### Example:
+  - Created Foo
+  - Fixed bar when xyz happened
+
+## Checklist
+  - [ ] Added tests
+  - [ ] All existing and new tests pass
+  - [ ] Updated README (if appropriate)
+  - [ ] Code lints (Rubocop) successfully
+  - [ ] Commits are according to our commit guidelines

data/README.md

@@ -61,6 +61,16 @@
     - [Listagem](#listagem)
     - [Atualizar conta bancária](#atualizar-conta-bancaria)
     - [Deletar conta bancária](#deletar-conta-bancaria)
+  - [Transferência](#transferência)
+    - [Criação](#criação-8)
+      -[Conta Bancária](#conta-bancária)
+      -[Conta Moip](#conta-moip-1)
+    - [Consulta](#consulta-9)
+    - [Listagem](#listagem-2)
+    - [Reversão](#reversão)
+  - [Custódia](#custódia)
+    - [Pagamento com custódia](#pagamento-com-custódia)
+    - [Liberação de custódia](#liberação-de-custódia)
   - [OAuth (Moip Connect)](#oauth-(moip-connect))
     - [Solicitar permissões de acesso ao usuário](#solicitar-permissões-de-acesso-ao-usuário)
     - [Gerar Token OAuth](#gerar-token-oauth)
@@ -81,6 +91,7 @@
 - [Tratamento de Exceções](#tratamento-de-exceções)
 - [Documentação](#documentação)
 - [Licença](#licença)
+- [Comunidade Slack](#comunidade-slack-) [![Slack](https://user-images.githubusercontent.com/4432322/37355972-ba0e9f32-26c3-11e8-93d3-39917eb24109.png)](https://slackin-cqtchmfquq.now.sh)
 
 
 ## Instalação
@@ -435,7 +446,12 @@ account = api.accounts.show("MPA-12312312312")
 
 ### Verifica se usuário já possui Conta Moip
 ```ruby
-api.accounts.exists?("123.456.789.10")
+api.accounts.exists?({tax_document: "123.456.789.10"})
+```
+
+### ou
+```ruby
+api.accounts.exists?({email: "dev.moip@labs.moip.com.br"})
 ```
 
 ## Conta bancária
@@ -491,6 +507,91 @@ api.bank_accounts.update("BKA-DWTSK16UQI9N",
   api.bank_accounts.delete("BKA-DWTSK16UQI9N")
 ```
 
+## Transferência
+### Criação
+#### Conta Bancária
+```ruby
+transfer = api.transfer.create(
+  amount: 500,
+  transferInstrument: {
+    method: "BANK_ACCOUNT",
+    bankAccount: {
+      type: "CHECKING",
+      bankNumber: "001",
+      agencyNumber: "1111",
+      agencyCheckNumber: "2",
+      accountNumber: "9999",
+      accountCheckNumber: "8",
+      holder: {
+        fullname: "Nome do Portador",
+        taxDocument: {
+          type: "CPF",
+          number: "22222222222",
+        },
+      },
+    },
+  },
+)
+```
+
+
+#### Conta Moip
+```ruby
+transfer = api.transfer.create(
+  amount: 500,
+  transferInstrument: {
+    method: "MOIP_ACCOUNT",
+    moipAccount: {
+      id: "MPA-B0D880F21EF1",
+    },
+  },
+)
+```
+
+### Consulta
+```ruby
+transfer = api.transfer.show("TRA-28HRLYNLMUFH")
+```
+
+### Listagem
+```ruby
+transfers = api.transfer.find_all()
+```
+
+### Reversão
+```ruby
+transfer = api.transfer.reverse("TRA-B0W5FD5FCADG")
+```
+## Custódia
+### Pagamento com custódia
+```ruby
+payment = api.payment.create(order.id,
+    {
+        installment_count: 1,
+        escrow: {
+          description: 'Custódia de pagamento'
+        },
+        funding_instrument: {
+            method: "CREDIT_CARD",
+            credit_card: {
+                expiration_month: 04,
+                expiration_year: 18,
+                number: "4002892240028922",
+                cvc: "123",
+                holder: {
+                    # ...
+                }
+            }
+        }
+    }
+)
+```
+
+### Liberação de custódia
+```ruby
+escrow = api.payment.release("ECW-JO3U4WIXD0CK")
+```
+
 ## OAuth (Moip Connect)
 ### Solicitar permissões de acesso ao usuário
 ```ruby
@@ -608,3 +709,7 @@ end
 ## Licença
 
 [The MIT License](https://github.com/moip/moip-sdk-ruby/blob/master/LICENSE.txt)
+
+## Comunidade Slack [![Slack](https://user-images.githubusercontent.com/4432322/37355972-ba0e9f32-26c3-11e8-93d3-39917eb24109.png)](https://slackin-cqtchmfquq.now.sh)
+
+Tem dúvidas? Fale com a gente no [Slack](https://slackin-cqtchmfquq.now.sh/)!

data/changelog.md

@@ -1,3 +1,23 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+
+<a name="v1.3.0"></a>
+# [](https://github.com/moip/moip-sdk-ruby/compare/v1.2.1...v1.3.0) (2018-02-19)
+
+
+#### Features
+
+* **Transfer**
+  * add transfers support ([4f89d76](https://github.com/moip/moip-sdk-ruby/commit/4f89d76))
+
+* **Escrow**
+  * add release escrow feature ([ef61c2d](https://github.com/moip/moip-sdk-ruby/commit/ef61c2d))
+
+
 <a name="v1.2.1"></a>
 ## v1.2.1 (2017-12-11)
 
@@ -6,7 +26,7 @@
 
 * **invoices**
   *  fix params on invoice list ((eb12108))
-  
+
 
 <a name="v1.2.0"></a>
 ## v1.2.0 (2017-12-7)

data/examples/marketplace/create-classical-account-company.rb

@@ -7,10 +7,12 @@ client = Moip2::Client.new(:sandbox, auth)
 api = Moip2::Api.new(client)
 
 # Check if account exists
-api.accounts.exists?("978.443.610-85")
+api.accounts.exists?({tax_document: "978.443.610-85"})
 
-# Create account
+# or
+api.accounts.exists?({email: "dev.moip@labs.moip.com.br"})
 
+# Create account
 account = api.accounts.create(
   email: {
     address: "dev.moip@labs.moip.com.br",

data/examples/marketplace/create-classical-account-without-company.rb

@@ -7,7 +7,10 @@ client = Moip2::Client.new(:sandbox, auth)
 api = Moip2::Api.new(client)
 
 # Check if account exists
-api.accounts.exists?("978.443.610-85")
+api.accounts.exists?({tax_document: "978.443.610-85"})
+
+# or
+api.accounts.exists?({email: "dev.moip@labs.moip.com.br"})
 
 # Create account
 account = api.accounts.create(

data/lib/moip2.rb

@@ -11,6 +11,7 @@ require "moip2/resource/account"
 require "moip2/resource/order"
 require "moip2/resource/entry"
 require "moip2/resource/payment"
+require "moip2/resource/transfer"
 require "moip2/resource/multi_order"
 require "moip2/resource/multi_payment"
 require "moip2/resource/customer"
@@ -23,6 +24,7 @@ require "moip2/resource/credit_card"
 require "moip2/resource/notification"
 require "moip2/resource/balances"
 require "moip2/resource/bank_account"
+require "moip2/resource/escrow"
 
 require "moip2/response"
 require "moip2/client"
@@ -31,6 +33,7 @@ require "moip2/order_api"
 require "moip2/entry_api"
 require "moip2/multi_order_api"
 require "moip2/payment_api"
+require "moip2/transfer_api"
 require "moip2/multi_payment_api"
 require "moip2/customer_api"
 require "moip2/invoice_api"

data/lib/moip2/accounts_api.rb

@@ -14,8 +14,10 @@ module Moip2
       Resource::Account.new client, client.post(base_path, account)
     end
 
-    def exists?(tax_document)
-      response = client.get("#{base_path}/exists?tax_document=#{tax_document}")
+    def exists?(data)
+      raise "Use: {email: 'dev@moip.com'} or {tax_document: '999.999.999-99'}" unless has_attribute_to_search(data)
+
+      response = client.get("#{base_path}/exists?#{to_search(data)}")
 
       response.success?
     end
@@ -23,5 +25,15 @@ module Moip2
     def show(id)
       Resource::Account.new client, client.get("#{base_path}/#{id}")
     end
+
+    private
+
+    def has_attribute_to_search(data)
+      data.key?(:tax_document) || data.key?(:email)
+    end
+
+    def to_search(data)
+      data.key?(:tax_document) ? "tax_document=#{data[:tax_document]}" : "email=#{data[:email]}"
+    end
   end
 end

data/lib/moip2/api.rb

@@ -14,6 +14,10 @@ module Moip2
       Moip2::PaymentApi.new(client)
     end
 
+    def transfer
+      Moip2::TransferApi.new(client)
+    end
+
     def balances
       Moip2::BalancesApi.new(client)
     end

data/lib/moip2/entry_api.rb

@@ -13,7 +13,7 @@ module Moip2
     def show(id)
       Resource::Entry.new client, client.get("#{base_path}/#{id}")
     end
-
+    
     def find_all
       Resource::Entry.new client, client.get("#{base_path}")
     end

data/lib/moip2/payment_api.rb

@@ -21,5 +21,9 @@ module Moip2
     def void(payment_id)
       Resource::Payment.new client.post("/v2/payments/#{payment_id}/void", nil)
     end
+
+    def release(escrow_id)
+      Resource::Escrow.new client.post("/v2/escrows/#{escrow_id}/release", nil)
+    end
   end
 end

data/lib/moip2/resource/escrow.rb

@@ -0,0 +1,9 @@
+module Moip2
+  module Resource
+    class Escrow < SimpleDelegator
+      def intialize(response)
+        super(response)
+      end
+    end
+  end
+end

data/lib/moip2/resource/transfer.rb

@@ -0,0 +1,9 @@
+module Moip2
+  module Resource
+    class Transfer < SimpleDelegator
+      def intialize(response)
+        super(response)
+      end
+    end
+  end
+end

data/lib/moip2/transfer_api.rb

@@ -0,0 +1,50 @@
+module Moip2
+  class TransferApi
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def create(transfer)
+      Resource::Transfer.new client.post(base_path, transfer)
+    end
+
+    def show(transfers_id)
+      Resource::Transfer.new client.get("#{base_path}/#{transfers_id}")
+    end
+
+    def find_all(limit: nil, offset: nil, filters: nil, status: nil)
+      response = client.get(uri_encode(limit, offset, filters, status))
+      Resource::Transfer.new json_to_object(response)
+    end
+
+    def reverse(transfers_id)
+      Resource::Transfer.new client.post("#{base_path}/#{transfers_id}/reverse", nil)
+    end
+
+    private
+
+    def base_path
+      "/v2/transfers"
+    end
+
+    def uri_encode(limit, offset, filters, status)
+      encoded_filters = Moip2::Util::FiltersEncoder.encode(filters)
+
+      params = {
+        limit: limit,
+        offset: offset,
+        filters: encoded_filters,
+        status: status,
+      }.reject { |_, value| value.nil? }
+      query_string = URI.encode_www_form(params)
+      path = "#{base_path}?#{query_string}"
+    end
+
+    def json_to_object(json)
+      json.transfers.map! { |transfer| Resource::Transfer.new transfer }
+      json
+    end
+  end
+end

data/lib/moip2/version.rb

@@ -1,3 +1,3 @@
 module Moip2
-  VERSION = "1.2.1".freeze
+  VERSION = "1.3.1".freeze
 end

data/spec/moip2/accounts_api_spec.rb

@@ -144,8 +144,8 @@ describe Moip2::AccountsApi do
   describe "#exists" do
     describe "with a registered tax document" do
       let(:existence_check) do
-        VCR.use_cassette("account_exists") do
-          accounts_api.exists?("436.130.670-21")
+        VCR.use_cassette("account_exists_for_tax_document") do
+          accounts_api.exists?({tax_document: "436.130.670-21"})
         end
       end
 
@@ -154,8 +154,28 @@ describe Moip2::AccountsApi do
 
     describe "with a non registered tax document" do
       let(:existence_check) do
-        VCR.use_cassette("account_doesnt_exist") do
-          accounts_api.exists?("555.000.123-40")
+        VCR.use_cassette("account_doesnt_exist_for_tax_document") do
+          accounts_api.exists?({tax_document: "555.000.123-40"})
+        end
+      end
+
+      it { expect(existence_check).to be false }
+    end
+
+    describe "with a registered email" do
+      let(:existence_check) do
+        VCR.use_cassette("account_exists_for_email") do
+          accounts_api.exists?({email: "dev.moip.1503312536@labs.moip.com.br"})
+        end
+      end
+
+      it { expect(existence_check).to be true }
+    end
+
+    describe "with a non registered email" do
+      let(:existence_check) do
+        VCR.use_cassette("account_doesnt_exist_for_email") do
+          accounts_api.exists?({email: "dev.moip.0123456789@labs.moip.com.br"})
         end
       end
 

data/spec/moip2/payment_api_spec.rb

@@ -133,4 +133,18 @@ describe Moip2::PaymentApi do
     it { expect(cancelled_payment.funding_instrument).to_not be_nil }
     it { expect(cancelled_payment.installment_count).to eq 1 }
   end
+
+  describe "#release" do
+    let(:payment_api_oauth) { described_class.new(sandbox_oauth_client) }
+    let (:released_escrow) do
+      VCR.use_cassette("release_escrow") do
+        payment_api_oauth.release("ECW-JO3U4WIXD0CK")
+      end
+    end
+
+    it { expect(released_escrow.id).to eq "ECW-JO3U4WIXD0CK" }
+    it { expect(released_escrow.status).to eq "RELEASED" }
+    it { expect(released_escrow.description).to eq "Custódia de pagamento" }
+    it { expect(released_escrow.amount).to eq 2000 }
+  end
 end