feat(escrow): add release escrow feature

Author: bressani

README.md

@@ -68,6 +68,9 @@
     - [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)
@@ -553,6 +556,35 @@ transfers = api.transfer.find_all()
 ```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

lib/moip2.rb

@@ -24,6 +24,7 @@
 require "moip2/resource/notification"
 require "moip2/resource/balances"
 require "moip2/resource/bank_account"
+require "moip2/resource/escrow"
 
 require "moip2/response"
 require "moip2/client"

lib/moip2/payment_api.rb

@@ -21,5 +21,9 @@ def capture(payment_id)
     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

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

spec/moip2/payment_api_spec.rb

@@ -133,4 +133,18 @@
     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