gocardless_pro 0.3.0

data/spec/services/refunds_service_spec.rb

@@ -0,0 +1,323 @@
+require 'spec_helper'
+
+describe GoCardlessPro::Services::RefundsService do
+  let(:client) do
+    GoCardlessPro::Client.new(
+      access_token: "SECRET_TOKEN"
+    )
+  end
+
+  
+  
+    
+
+    
+    describe "#create" do
+    subject(:post_create_response) { client.refunds.create(params: new_resource) }
+      context "with a valid request" do
+        let(:new_resource) do
+          {
+          
+          "amount" => "amount-input",
+          "created_at" => "created_at-input",
+          "currency" => "currency-input",
+          "id" => "id-input",
+          "links" => "links-input",
+          "metadata" => "metadata-input",
+          }
+        end
+
+        before do
+          stub_request(:post, /.*api.gocardless.com\/refunds/).
+          with(
+            body: {
+              refunds: {
+                
+                "amount" => "amount-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "id" => "id-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                }
+            }
+          ).
+          to_return(
+            body: {
+              refunds: {
+                
+                "amount" => "amount-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "id" => "id-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        it "creates and returns the resource" do
+          expect(post_create_response).to be_a(GoCardlessPro::Resources::Refund)
+        end
+      end
+
+      context "with a request that returns a validation error" do
+        let(:new_resource) { {} }
+
+        before do
+          stub_request(:post, /.*api.gocardless.com\/refunds/).to_return(
+            body: {
+              error: {
+                type: 'validation_failed',
+                code: 422,
+                errors: [
+                  { message: 'test error message', field: 'test_field' }
+                ]
+              }
+            }.to_json,
+            headers: {'Content-Type' => 'application/json'},
+            status: 422
+          )
+        end
+
+        it "throws the correct error" do
+          expect { post_create_response }.to raise_error(GoCardlessPro::ValidationError)
+        end
+      end
+    end
+    
+  
+    
+
+    
+    describe "#list" do
+      describe "with no filters" do
+        subject(:get_list_response) { client.refunds.list }
+
+        before do
+          stub_request(:get, /.*api.gocardless.com\/refunds/).to_return(
+            body: {
+              refunds: [{
+                
+                "amount" => "amount-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "id" => "id-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                }],
+                meta: {
+                  cursors: {
+                    before: nil,
+                    after: "ABC123"
+                  }
+                }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        it "wraps each item in the resource class" do
+          expect(get_list_response.records.map { |x| x.class }.uniq.first).to eq(GoCardlessPro::Resources::Refund)
+
+          
+          
+          expect(get_list_response.records.first.amount).to eq("amount-input")
+          
+          
+          
+          expect(get_list_response.records.first.created_at).to eq("created_at-input")
+          
+          
+          
+          expect(get_list_response.records.first.currency).to eq("currency-input")
+          
+          
+          
+          expect(get_list_response.records.first.id).to eq("id-input")
+          
+          
+          
+          
+          
+          expect(get_list_response.records.first.metadata).to eq("metadata-input")
+          
+          
+        end
+
+        it "exposes the cursors for before and after" do
+          expect(get_list_response.before).to eq(nil)
+          expect(get_list_response.after).to eq("ABC123")
+        end
+      end
+    end
+
+    describe "#all" do
+      let!(:first_response_stub) do
+        stub_request(:get, /.*api.gocardless.com\/refunds$/).to_return(
+          body: {
+            refunds: [{
+              
+              "amount" => "amount-input",
+              "created_at" => "created_at-input",
+              "currency" => "currency-input",
+              "id" => "id-input",
+              "links" => "links-input",
+              "metadata" => "metadata-input",
+            }],
+            meta: {
+              cursors: { after: 'AB345' },
+              limit: 1
+            }
+          }.to_json,
+          :headers => {'Content-Type' => 'application/json'}
+        )
+      end
+
+      let!(:second_response_stub) do
+        stub_request(:get, /.*api.gocardless.com\/refunds\?after=AB345/).to_return(
+          body: {
+            refunds: [{
+              
+              "amount" => "amount-input",
+              "created_at" => "created_at-input",
+              "currency" => "currency-input",
+              "id" => "id-input",
+              "links" => "links-input",
+              "metadata" => "metadata-input",
+            }],
+            meta: {
+              limit: 2,
+              cursors: {}
+            }
+          }.to_json,
+          :headers => {'Content-Type' => 'application/json'}
+        )
+      end
+
+      it "automatically makes the extra requests" do
+        expect(client.refunds.all.to_a.length).to eq(2)
+        expect(first_response_stub).to have_been_requested
+        expect(second_response_stub).to have_been_requested
+      end
+    end
+
+    
+  
+    
+
+    
+    describe "#get" do
+      let(:id) { "ID123" }
+
+      subject(:get_response) { client.refunds.get(id) }
+
+      context "passing in a custom header" do
+        let!(:stub) do
+          stub_request(:get, /.*api.gocardless.com\/refunds\/ID123/)
+          .with(headers: { 'Foo' => 'Bar' })
+          .to_return(
+            body: {
+              refunds: {
+                
+                "amount" => "amount-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "id" => "id-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+              }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        subject(:get_response) do
+          client.refunds.get(id, headers: {
+            'Foo' => 'Bar'
+          })
+        end
+
+        it "includes the header" do
+          get_response
+          expect(stub).to have_been_requested
+        end
+      end
+
+      context "when there is a refund to return" do
+        before do
+          stub_request(:get, /.*api.gocardless.com\/refunds\/ID123/).to_return(
+            body: {
+              refunds: {
+                
+                "amount" => "amount-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "id" => "id-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+              }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        it "wraps the response in a resource" do
+          expect(get_response).to be_a(GoCardlessPro::Resources::Refund)
+        end
+      end
+
+      context "when nothing is returned" do
+        before do
+          stub_request(:get, /.*api.gocardless.com\/refunds\/ID123/).to_return(
+            body: "",
+            headers: { 'Content-Type' => 'application/json' }
+          )
+        end
+
+        it "returns nil" do
+          expect(get_response).to be_nil
+        end
+      end
+    end
+
+    
+  
+    
+
+    
+    describe "#update" do
+      subject(:put_update_response) { client.refunds.update(id, params: update_params) }
+      let(:id) { "ABC123" }
+
+      context "with a valid request" do
+        let(:update_params) { { "hello" => "world" } }
+
+        let!(:stub) do
+          stub_request(:put, /.*api.gocardless.com\/refunds\/ABC123/).to_return(
+            body: {
+              refunds: {
+                
+                "amount" => "amount-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "id" => "id-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+              }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        it "updates and returns the resource" do
+          expect(put_update_response).to be_a(GoCardlessPro::Resources::Refund)
+          expect(stub).to have_been_requested
+        end
+      end
+    end
+    
+  
+end

data/spec/services/subscriptions_service_spec.rb

@@ -0,0 +1,557 @@
+require 'spec_helper'
+
+describe GoCardlessPro::Services::SubscriptionsService do
+  let(:client) do
+    GoCardlessPro::Client.new(
+      access_token: "SECRET_TOKEN"
+    )
+  end
+
+  
+  
+    
+
+    
+    describe "#create" do
+    subject(:post_create_response) { client.subscriptions.create(params: new_resource) }
+      context "with a valid request" do
+        let(:new_resource) do
+          {
+          
+          "amount" => "amount-input",
+          "count" => "count-input",
+          "created_at" => "created_at-input",
+          "currency" => "currency-input",
+          "day_of_month" => "day_of_month-input",
+          "end_at" => "end_at-input",
+          "id" => "id-input",
+          "interval" => "interval-input",
+          "interval_unit" => "interval_unit-input",
+          "links" => "links-input",
+          "metadata" => "metadata-input",
+          "month" => "month-input",
+          "name" => "name-input",
+          "payment_reference" => "payment_reference-input",
+          "start_at" => "start_at-input",
+          "status" => "status-input",
+          "upcoming_payments" => "upcoming_payments-input",
+          }
+        end
+
+        before do
+          stub_request(:post, /.*api.gocardless.com\/subscriptions/).
+          with(
+            body: {
+              subscriptions: {
+                
+                "amount" => "amount-input",
+                "count" => "count-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "day_of_month" => "day_of_month-input",
+                "end_at" => "end_at-input",
+                "id" => "id-input",
+                "interval" => "interval-input",
+                "interval_unit" => "interval_unit-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                "month" => "month-input",
+                "name" => "name-input",
+                "payment_reference" => "payment_reference-input",
+                "start_at" => "start_at-input",
+                "status" => "status-input",
+                "upcoming_payments" => "upcoming_payments-input",
+                }
+            }
+          ).
+          to_return(
+            body: {
+              subscriptions: {
+                
+                "amount" => "amount-input",
+                "count" => "count-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "day_of_month" => "day_of_month-input",
+                "end_at" => "end_at-input",
+                "id" => "id-input",
+                "interval" => "interval-input",
+                "interval_unit" => "interval_unit-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                "month" => "month-input",
+                "name" => "name-input",
+                "payment_reference" => "payment_reference-input",
+                "start_at" => "start_at-input",
+                "status" => "status-input",
+                "upcoming_payments" => "upcoming_payments-input",
+                }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        it "creates and returns the resource" do
+          expect(post_create_response).to be_a(GoCardlessPro::Resources::Subscription)
+        end
+      end
+
+      context "with a request that returns a validation error" do
+        let(:new_resource) { {} }
+
+        before do
+          stub_request(:post, /.*api.gocardless.com\/subscriptions/).to_return(
+            body: {
+              error: {
+                type: 'validation_failed',
+                code: 422,
+                errors: [
+                  { message: 'test error message', field: 'test_field' }
+                ]
+              }
+            }.to_json,
+            headers: {'Content-Type' => 'application/json'},
+            status: 422
+          )
+        end
+
+        it "throws the correct error" do
+          expect { post_create_response }.to raise_error(GoCardlessPro::ValidationError)
+        end
+      end
+    end
+    
+  
+    
+
+    
+    describe "#list" do
+      describe "with no filters" do
+        subject(:get_list_response) { client.subscriptions.list }
+
+        before do
+          stub_request(:get, /.*api.gocardless.com\/subscriptions/).to_return(
+            body: {
+              subscriptions: [{
+                
+                "amount" => "amount-input",
+                "count" => "count-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "day_of_month" => "day_of_month-input",
+                "end_at" => "end_at-input",
+                "id" => "id-input",
+                "interval" => "interval-input",
+                "interval_unit" => "interval_unit-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                "month" => "month-input",
+                "name" => "name-input",
+                "payment_reference" => "payment_reference-input",
+                "start_at" => "start_at-input",
+                "status" => "status-input",
+                "upcoming_payments" => "upcoming_payments-input",
+                }],
+                meta: {
+                  cursors: {
+                    before: nil,
+                    after: "ABC123"
+                  }
+                }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        it "wraps each item in the resource class" do
+          expect(get_list_response.records.map { |x| x.class }.uniq.first).to eq(GoCardlessPro::Resources::Subscription)
+
+          
+          
+          expect(get_list_response.records.first.amount).to eq("amount-input")
+          
+          
+          
+          expect(get_list_response.records.first.count).to eq("count-input")
+          
+          
+          
+          expect(get_list_response.records.first.created_at).to eq("created_at-input")
+          
+          
+          
+          expect(get_list_response.records.first.currency).to eq("currency-input")
+          
+          
+          
+          expect(get_list_response.records.first.day_of_month).to eq("day_of_month-input")
+          
+          
+          
+          expect(get_list_response.records.first.end_at).to eq("end_at-input")
+          
+          
+          
+          expect(get_list_response.records.first.id).to eq("id-input")
+          
+          
+          
+          expect(get_list_response.records.first.interval).to eq("interval-input")
+          
+          
+          
+          expect(get_list_response.records.first.interval_unit).to eq("interval_unit-input")
+          
+          
+          
+          
+          
+          expect(get_list_response.records.first.metadata).to eq("metadata-input")
+          
+          
+          
+          expect(get_list_response.records.first.month).to eq("month-input")
+          
+          
+          
+          expect(get_list_response.records.first.name).to eq("name-input")
+          
+          
+          
+          expect(get_list_response.records.first.payment_reference).to eq("payment_reference-input")
+          
+          
+          
+          expect(get_list_response.records.first.start_at).to eq("start_at-input")
+          
+          
+          
+          expect(get_list_response.records.first.status).to eq("status-input")
+          
+          
+          
+          expect(get_list_response.records.first.upcoming_payments).to eq("upcoming_payments-input")
+          
+          
+        end
+
+        it "exposes the cursors for before and after" do
+          expect(get_list_response.before).to eq(nil)
+          expect(get_list_response.after).to eq("ABC123")
+        end
+      end
+    end
+
+    describe "#all" do
+      let!(:first_response_stub) do
+        stub_request(:get, /.*api.gocardless.com\/subscriptions$/).to_return(
+          body: {
+            subscriptions: [{
+              
+              "amount" => "amount-input",
+              "count" => "count-input",
+              "created_at" => "created_at-input",
+              "currency" => "currency-input",
+              "day_of_month" => "day_of_month-input",
+              "end_at" => "end_at-input",
+              "id" => "id-input",
+              "interval" => "interval-input",
+              "interval_unit" => "interval_unit-input",
+              "links" => "links-input",
+              "metadata" => "metadata-input",
+              "month" => "month-input",
+              "name" => "name-input",
+              "payment_reference" => "payment_reference-input",
+              "start_at" => "start_at-input",
+              "status" => "status-input",
+              "upcoming_payments" => "upcoming_payments-input",
+            }],
+            meta: {
+              cursors: { after: 'AB345' },
+              limit: 1
+            }
+          }.to_json,
+          :headers => {'Content-Type' => 'application/json'}
+        )
+      end
+
+      let!(:second_response_stub) do
+        stub_request(:get, /.*api.gocardless.com\/subscriptions\?after=AB345/).to_return(
+          body: {
+            subscriptions: [{
+              
+              "amount" => "amount-input",
+              "count" => "count-input",
+              "created_at" => "created_at-input",
+              "currency" => "currency-input",
+              "day_of_month" => "day_of_month-input",
+              "end_at" => "end_at-input",
+              "id" => "id-input",
+              "interval" => "interval-input",
+              "interval_unit" => "interval_unit-input",
+              "links" => "links-input",
+              "metadata" => "metadata-input",
+              "month" => "month-input",
+              "name" => "name-input",
+              "payment_reference" => "payment_reference-input",
+              "start_at" => "start_at-input",
+              "status" => "status-input",
+              "upcoming_payments" => "upcoming_payments-input",
+            }],
+            meta: {
+              limit: 2,
+              cursors: {}
+            }
+          }.to_json,
+          :headers => {'Content-Type' => 'application/json'}
+        )
+      end
+
+      it "automatically makes the extra requests" do
+        expect(client.subscriptions.all.to_a.length).to eq(2)
+        expect(first_response_stub).to have_been_requested
+        expect(second_response_stub).to have_been_requested
+      end
+    end
+
+    
+  
+    
+
+    
+    describe "#get" do
+      let(:id) { "ID123" }
+
+      subject(:get_response) { client.subscriptions.get(id) }
+
+      context "passing in a custom header" do
+        let!(:stub) do
+          stub_request(:get, /.*api.gocardless.com\/subscriptions\/ID123/)
+          .with(headers: { 'Foo' => 'Bar' })
+          .to_return(
+            body: {
+              subscriptions: {
+                
+                "amount" => "amount-input",
+                "count" => "count-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "day_of_month" => "day_of_month-input",
+                "end_at" => "end_at-input",
+                "id" => "id-input",
+                "interval" => "interval-input",
+                "interval_unit" => "interval_unit-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                "month" => "month-input",
+                "name" => "name-input",
+                "payment_reference" => "payment_reference-input",
+                "start_at" => "start_at-input",
+                "status" => "status-input",
+                "upcoming_payments" => "upcoming_payments-input",
+              }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        subject(:get_response) do
+          client.subscriptions.get(id, headers: {
+            'Foo' => 'Bar'
+          })
+        end
+
+        it "includes the header" do
+          get_response
+          expect(stub).to have_been_requested
+        end
+      end
+
+      context "when there is a subscription to return" do
+        before do
+          stub_request(:get, /.*api.gocardless.com\/subscriptions\/ID123/).to_return(
+            body: {
+              subscriptions: {
+                
+                "amount" => "amount-input",
+                "count" => "count-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "day_of_month" => "day_of_month-input",
+                "end_at" => "end_at-input",
+                "id" => "id-input",
+                "interval" => "interval-input",
+                "interval_unit" => "interval_unit-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                "month" => "month-input",
+                "name" => "name-input",
+                "payment_reference" => "payment_reference-input",
+                "start_at" => "start_at-input",
+                "status" => "status-input",
+                "upcoming_payments" => "upcoming_payments-input",
+              }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        it "wraps the response in a resource" do
+          expect(get_response).to be_a(GoCardlessPro::Resources::Subscription)
+        end
+      end
+
+      context "when nothing is returned" do
+        before do
+          stub_request(:get, /.*api.gocardless.com\/subscriptions\/ID123/).to_return(
+            body: "",
+            headers: { 'Content-Type' => 'application/json' }
+          )
+        end
+
+        it "returns nil" do
+          expect(get_response).to be_nil
+        end
+      end
+    end
+
+    
+  
+    
+
+    
+    describe "#update" do
+      subject(:put_update_response) { client.subscriptions.update(id, params: update_params) }
+      let(:id) { "ABC123" }
+
+      context "with a valid request" do
+        let(:update_params) { { "hello" => "world" } }
+
+        let!(:stub) do
+          stub_request(:put, /.*api.gocardless.com\/subscriptions\/ABC123/).to_return(
+            body: {
+              subscriptions: {
+                
+                "amount" => "amount-input",
+                "count" => "count-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "day_of_month" => "day_of_month-input",
+                "end_at" => "end_at-input",
+                "id" => "id-input",
+                "interval" => "interval-input",
+                "interval_unit" => "interval_unit-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                "month" => "month-input",
+                "name" => "name-input",
+                "payment_reference" => "payment_reference-input",
+                "start_at" => "start_at-input",
+                "status" => "status-input",
+                "upcoming_payments" => "upcoming_payments-input",
+              }
+            }.to_json,
+            :headers => {'Content-Type' => 'application/json'}
+          )
+        end
+
+        it "updates and returns the resource" do
+          expect(put_update_response).to be_a(GoCardlessPro::Resources::Subscription)
+          expect(stub).to have_been_requested
+        end
+      end
+    end
+    
+  
+    
+
+    
+    describe "#cancel" do
+      
+      
+        subject(:post_response) { client.subscriptions.cancel(resource_id) }
+      
+      let(:resource_id) { "ABC123" }
+
+      let!(:stub) do
+        # /subscriptions/%v/actions/cancel
+        stub_url = "/subscriptions/:identity/actions/cancel".gsub(':identity', resource_id)
+        stub_request(:post, /.*api.gocardless.com#{stub_url}/).to_return(
+          body: {
+            subscriptions: {
+              
+              "amount" => "amount-input",
+              "count" => "count-input",
+              "created_at" => "created_at-input",
+              "currency" => "currency-input",
+              "day_of_month" => "day_of_month-input",
+              "end_at" => "end_at-input",
+              "id" => "id-input",
+              "interval" => "interval-input",
+              "interval_unit" => "interval_unit-input",
+              "links" => "links-input",
+              "metadata" => "metadata-input",
+              "month" => "month-input",
+              "name" => "name-input",
+              "payment_reference" => "payment_reference-input",
+              "start_at" => "start_at-input",
+              "status" => "status-input",
+              "upcoming_payments" => "upcoming_payments-input",
+            }
+          }.to_json,
+          headers: {'Content-Type' => 'application/json'},
+        )
+      end
+
+      it "wraps the response and calls the right endpoint" do
+        expect(post_response).to be_a(GoCardlessPro::Resources::Subscription)
+
+        expect(stub).to have_been_requested
+      end
+
+      context "when the request needs a body and custom header" do
+        
+          let(:body) { { foo: 'bar' } }
+          let(:headers) { { 'Foo' => 'Bar' } }
+          subject(:post_response) { client.subscriptions.cancel(resource_id, body, headers) }
+        
+        let(:resource_id) { "ABC123" }
+
+        let!(:stub) do
+          # /subscriptions/%v/actions/cancel
+          stub_url = "/subscriptions/:identity/actions/cancel".gsub(':identity', resource_id)
+          stub_request(:post, /.*api.gocardless.com#{stub_url}/).
+          with(
+            body: { foo: 'bar' },
+            headers: { 'Foo' => 'Bar' }
+          ).to_return(
+            body: {
+              subscriptions: {
+                
+                "amount" => "amount-input",
+                "count" => "count-input",
+                "created_at" => "created_at-input",
+                "currency" => "currency-input",
+                "day_of_month" => "day_of_month-input",
+                "end_at" => "end_at-input",
+                "id" => "id-input",
+                "interval" => "interval-input",
+                "interval_unit" => "interval_unit-input",
+                "links" => "links-input",
+                "metadata" => "metadata-input",
+                "month" => "month-input",
+                "name" => "name-input",
+                "payment_reference" => "payment_reference-input",
+                "start_at" => "start_at-input",
+                "status" => "status-input",
+                "upcoming_payments" => "upcoming_payments-input",
+              }
+            }.to_json,
+            headers: {'Content-Type' => 'application/json'},
+          )
+        end
+      end
+    end
+    
+  
+end