gocardless_pro 1.1.0 → 2.0.0

data/spec/resources/event_spec.rb

@@ -1,103 +1,202 @@
 require 'spec_helper'
 
 describe GoCardlessPro::Resources::Event do
-  describe 'initialising' do
-    let(:data) do
-      {
-
-        'action' => 'action-input',
-
-        'created_at' => 'created_at-input',
-
-        'details' => 'details-input',
-
-        'id' => 'id-input',
-
-        'links' => {
-
-          'mandate' => 'mandate-input',
-
-          'new_customer_bank_account' => 'new_customer_bank_account-input',
-
-          'new_mandate' => 'new_mandate-input',
-
-          'organisation' => 'organisation-input',
+  let(:client) do
+    GoCardlessPro::Client.new(
+      access_token: 'SECRET_TOKEN'
+    )
+  end
 
-          'parent_event' => 'parent_event-input',
+  let(:response_headers) { { 'Content-Type' => 'application/json' } }
+
+  describe '#list' do
+    describe 'with no filters' do
+      subject(:get_list_response) { client.events.list }
+
+      before do
+        stub_request(:get, %r{.*api.gocardless.com/events}).to_return(
+          body: {
+            'events' => [{
+
+              'action' => 'action-input',
+              'created_at' => 'created_at-input',
+              'details' => 'details-input',
+              'id' => 'id-input',
+              'links' => 'links-input',
+              'metadata' => 'metadata-input',
+              'resource_type' => 'resource_type-input'
+            }],
+            meta: {
+              cursors: {
+                before: nil,
+                after: 'ABC123'
+              }
+            }
+          }.to_json,
+          headers: response_headers
+        )
+      end
 
-          'payment' => 'payment-input',
+      it 'wraps each item in the resource class' do
+        expect(get_list_response.records.map(&:class).uniq.first).to eq(GoCardlessPro::Resources::Event)
 
-          'payout' => 'payout-input',
+        expect(get_list_response.records.first.action).to eq('action-input')
 
-          'previous_customer_bank_account' => 'previous_customer_bank_account-input',
+        expect(get_list_response.records.first.created_at).to eq('created_at-input')
 
-          'refund' => 'refund-input',
+        expect(get_list_response.records.first.details).to eq('details-input')
 
-          'subscription' => 'subscription-input'
+        expect(get_list_response.records.first.id).to eq('id-input')
 
-        },
+        expect(get_list_response.records.first.metadata).to eq('metadata-input')
 
-        'metadata' => 'metadata-input',
+        expect(get_list_response.records.first.resource_type).to eq('resource_type-input')
+      end
 
-        'resource_type' => 'resource_type-input'
+      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
 
-      }
+      specify { expect(get_list_response.api_response.headers).to eql('content-type' => 'application/json') }
     end
+  end
 
-    it 'can be initialized from an unenveloped response' do
-      resource = described_class.new(data)
-
-      expect(resource.action).to eq('action-input')
-
-      expect(resource.created_at).to eq('created_at-input')
-
-      expect(resource.details).to eq('details-input')
-
-      expect(resource.id).to eq('id-input')
-
-      expect(resource.links.mandate).to eq('mandate-input')
-
-      expect(resource.links.new_customer_bank_account).to eq('new_customer_bank_account-input')
-
-      expect(resource.links.new_mandate).to eq('new_mandate-input')
-
-      expect(resource.links.organisation).to eq('organisation-input')
-
-      expect(resource.links.parent_event).to eq('parent_event-input')
+  describe '#all' do
+    let!(:first_response_stub) do
+      stub_request(:get, %r{.*api.gocardless.com/events$}).to_return(
+        body: {
+          'events' => [{
+
+            'action' => 'action-input',
+            'created_at' => 'created_at-input',
+            'details' => 'details-input',
+            'id' => 'id-input',
+            'links' => 'links-input',
+            'metadata' => 'metadata-input',
+            'resource_type' => 'resource_type-input'
+          }],
+          meta: {
+            cursors: { after: 'AB345' },
+            limit: 1
+          }
+        }.to_json,
+        headers: response_headers
+      )
+    end
 
-      expect(resource.links.payment).to eq('payment-input')
+    let!(:second_response_stub) do
+      stub_request(:get, %r{.*api.gocardless.com/events\?after=AB345}).to_return(
+        body: {
+          'events' => [{
+
+            'action' => 'action-input',
+            'created_at' => 'created_at-input',
+            'details' => 'details-input',
+            'id' => 'id-input',
+            'links' => 'links-input',
+            'metadata' => 'metadata-input',
+            'resource_type' => 'resource_type-input'
+          }],
+          meta: {
+            limit: 2,
+            cursors: {}
+          }
+        }.to_json,
+        headers: response_headers
+      )
+    end
 
-      expect(resource.links.payout).to eq('payout-input')
+    it 'automatically makes the extra requests' do
+      expect(client.events.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
 
-      expect(resource.links.previous_customer_bank_account).to eq('previous_customer_bank_account-input')
+  describe '#get' do
+    let(:id) { 'ID123' }
+
+    subject(:get_response) { client.events.get(id) }
+
+    context 'passing in a custom header' do
+      let!(:stub) do
+        stub_url = '/events/:identity'.gsub(':identity', id)
+        stub_request(:get, /.*api.gocardless.com#{stub_url}/)
+          .with(headers: { 'Foo' => 'Bar' })
+          .to_return(
+            body: {
+              'events' => {
+
+                'action' => 'action-input',
+                'created_at' => 'created_at-input',
+                'details' => 'details-input',
+                'id' => 'id-input',
+                'links' => 'links-input',
+                'metadata' => 'metadata-input',
+                'resource_type' => 'resource_type-input'
+              }
+            }.to_json,
+            headers: response_headers
+          )
+      end
 
-      expect(resource.links.refund).to eq('refund-input')
+      subject(:get_response) do
+        client.events.get(id, headers: {
+                            'Foo' => 'Bar'
+                          })
+      end
 
-      expect(resource.links.subscription).to eq('subscription-input')
+      it 'includes the header' do
+        get_response
+        expect(stub).to have_been_requested
+      end
+    end
 
-      expect(resource.metadata).to eq('metadata-input')
+    context 'when there is a event to return' do
+      before do
+        stub_url = '/events/:identity'.gsub(':identity', id)
+        stub_request(:get, /.*api.gocardless.com#{stub_url}/).to_return(
+          body: {
+            'events' => {
+
+              'action' => 'action-input',
+              'created_at' => 'created_at-input',
+              'details' => 'details-input',
+              'id' => 'id-input',
+              'links' => 'links-input',
+              'metadata' => 'metadata-input',
+              'resource_type' => 'resource_type-input'
+            }
+          }.to_json,
+          headers: response_headers
+        )
+      end
 
-      expect(resource.resource_type).to eq('resource_type-input')
+      it 'wraps the response in a resource' do
+        expect(get_response).to be_a(GoCardlessPro::Resources::Event)
+      end
     end
 
-    it 'can handle new attributes without erroring' do
-      data['foo'] = 'bar'
-      expect { described_class.new(data) }.to_not raise_error
-    end
+    context 'when nothing is returned' do
+      before do
+        stub_url = '/events/:identity'.gsub(':identity', id)
+        stub_request(:get, /.*api.gocardless.com#{stub_url}/).to_return(
+          body: '',
+          headers: response_headers
+        )
+      end
 
-    it 'can handle new link attributes without erroring' do
-      data['links']['foo'] = 'bar'
-      expect { described_class.new(data) }.to_not raise_error
+      it 'returns nil' do
+        expect(get_response).to be_nil
+      end
     end
 
-    it 'can handle a nil links value' do
-      data['links'] = nil
-      expect { described_class.new(data).links }.to_not raise_error
-    end
+    context "when an ID is specified which can't be included in a valid URI" do
+      let(:id) { '`' }
 
-    describe '#to_h' do
-      it 'returns a hash representing the resource' do
-        expect(described_class.new(data).to_h).to eq(data)
+      it "doesn't raise an error" do
+        expect { get_response }.to_not raise_error(/bad URI/)
       end
     end
   end

data/spec/resources/mandate_pdf_spec.rb

@@ -1,33 +1,116 @@
 require 'spec_helper'
 
 describe GoCardlessPro::Resources::MandatePdf do
-  describe 'initialising' do
-    let(:data) do
-      {
+  let(:client) do
+    GoCardlessPro::Client.new(
+      access_token: 'SECRET_TOKEN'
+    )
+  end
 
-        'expires_at' => 'expires_at-input',
+  let(:response_headers) { { 'Content-Type' => 'application/json' } }
 
-        'url' => 'url-input'
+  describe '#create' do
+    subject(:post_create_response) { client.mandate_pdfs.create(params: new_resource) }
+    context 'with a valid request' do
+      let(:new_resource) do
+        {
 
-      }
-    end
+          'expires_at' => 'expires_at-input',
+          'url' => 'url-input'
+        }
+      end
+
+      before do
+        stub_request(:post, %r{.*api.gocardless.com/mandate_pdfs})
+          .with(
+            body: {
+              'mandate_pdfs' => {
+
+                'expires_at' => 'expires_at-input',
+                'url' => 'url-input'
+              }
+            }
+          )
+          .to_return(
+            body: {
+              'mandate_pdfs' =>
 
-    it 'can be initialized from an unenveloped response' do
-      resource = described_class.new(data)
+                {
 
-      expect(resource.expires_at).to eq('expires_at-input')
+                  'expires_at' => 'expires_at-input',
+                  'url' => 'url-input'
+                }
 
-      expect(resource.url).to eq('url-input')
+            }.to_json,
+            headers: response_headers
+          )
+      end
+
+      it 'creates and returns the resource' do
+        expect(post_create_response).to be_a(GoCardlessPro::Resources::MandatePdf)
+      end
     end
 
-    it 'can handle new attributes without erroring' do
-      data['foo'] = 'bar'
-      expect { described_class.new(data) }.to_not raise_error
+    context 'with a request that returns a validation error' do
+      let(:new_resource) { {} }
+
+      before do
+        stub_request(:post, %r{.*api.gocardless.com/mandate_pdfs}).to_return(
+          body: {
+            error: {
+              type: 'validation_failed',
+              code: 422,
+              errors: [
+                { message: 'test error message', field: 'test_field' }
+              ]
+            }
+          }.to_json,
+          headers: response_headers,
+          status: 422
+        )
+      end
+
+      it 'throws the correct error' do
+        expect { post_create_response }.to raise_error(GoCardlessPro::ValidationError)
+      end
     end
 
-    describe '#to_h' do
-      it 'returns a hash representing the resource' do
-        expect(described_class.new(data).to_h).to eq(data)
+    context 'with a request that returns an idempotent creation conflict error' do
+      let(:id) { 'ID123' }
+
+      let(:new_resource) do
+        {
+
+          'expires_at' => 'expires_at-input',
+          'url' => 'url-input'
+        }
+      end
+
+      let!(:post_stub) do
+        stub_request(:post, %r{.*api.gocardless.com/mandate_pdfs}).to_return(
+          body: {
+            error: {
+              type: 'invalid_state',
+              code: 409,
+              errors: [
+                {
+                  message: 'A resource has already been created with this idempotency key',
+                  reason: 'idempotent_creation_conflict',
+                  links: {
+                    conflicting_resource_id: id
+                  }
+                }
+              ]
+            }
+          }.to_json,
+          headers: response_headers,
+          status: 409
+        )
+      end
+
+      it 'raises an InvalidStateError' do
+        expect { post_create_response }.to raise_error(GoCardlessPro::InvalidStateError)
+        expect(post_stub).to have_been_requested
       end
     end
   end

data/spec/resources/mandate_spec.rb

@@ -1,87 +1,544 @@
 require 'spec_helper'
 
 describe GoCardlessPro::Resources::Mandate do
-  describe 'initialising' do
-    let(:data) do
-      {
+  let(:client) do
+    GoCardlessPro::Client.new(
+      access_token: 'SECRET_TOKEN'
+    )
+  end
 
-        'created_at' => 'created_at-input',
+  let(:response_headers) { { 'Content-Type' => 'application/json' } }
+
+  describe '#create' do
+    subject(:post_create_response) { client.mandates.create(params: new_resource) }
+    context 'with a valid request' do
+      let(:new_resource) do
+        {
+
+          'created_at' => 'created_at-input',
+          'id' => 'id-input',
+          'links' => 'links-input',
+          'metadata' => 'metadata-input',
+          'next_possible_charge_date' => 'next_possible_charge_date-input',
+          'payments_require_approval' => 'payments_require_approval-input',
+          'reference' => 'reference-input',
+          'scheme' => 'scheme-input',
+          'status' => 'status-input'
+        }
+      end
 
-        'id' => 'id-input',
+      before do
+        stub_request(:post, %r{.*api.gocardless.com/mandates})
+          .with(
+            body: {
+              'mandates' => {
+
+                'created_at' => 'created_at-input',
+                'id' => 'id-input',
+                'links' => 'links-input',
+                'metadata' => 'metadata-input',
+                'next_possible_charge_date' => 'next_possible_charge_date-input',
+                'payments_require_approval' => 'payments_require_approval-input',
+                'reference' => 'reference-input',
+                'scheme' => 'scheme-input',
+                'status' => 'status-input'
+              }
+            }
+          )
+          .to_return(
+            body: {
+              'mandates' =>
+
+                {
+
+                  'created_at' => 'created_at-input',
+                  'id' => 'id-input',
+                  'links' => 'links-input',
+                  'metadata' => 'metadata-input',
+                  'next_possible_charge_date' => 'next_possible_charge_date-input',
+                  'payments_require_approval' => 'payments_require_approval-input',
+                  'reference' => 'reference-input',
+                  'scheme' => 'scheme-input',
+                  'status' => 'status-input'
+                }
+
+            }.to_json,
+            headers: response_headers
+          )
+      end
 
-        'links' => {
+      it 'creates and returns the resource' do
+        expect(post_create_response).to be_a(GoCardlessPro::Resources::Mandate)
+      end
+    end
 
-          'creditor' => 'creditor-input',
+    context 'with a request that returns a validation error' do
+      let(:new_resource) { {} }
+
+      before do
+        stub_request(:post, %r{.*api.gocardless.com/mandates}).to_return(
+          body: {
+            error: {
+              type: 'validation_failed',
+              code: 422,
+              errors: [
+                { message: 'test error message', field: 'test_field' }
+              ]
+            }
+          }.to_json,
+          headers: response_headers,
+          status: 422
+        )
+      end
 
-          'customer' => 'customer-input',
+      it 'throws the correct error' do
+        expect { post_create_response }.to raise_error(GoCardlessPro::ValidationError)
+      end
+    end
 
-          'customer_bank_account' => 'customer_bank_account-input',
+    context 'with a request that returns an idempotent creation conflict error' do
+      let(:id) { 'ID123' }
+
+      let(:new_resource) do
+        {
+
+          'created_at' => 'created_at-input',
+          'id' => 'id-input',
+          'links' => 'links-input',
+          'metadata' => 'metadata-input',
+          'next_possible_charge_date' => 'next_possible_charge_date-input',
+          'payments_require_approval' => 'payments_require_approval-input',
+          'reference' => 'reference-input',
+          'scheme' => 'scheme-input',
+          'status' => 'status-input'
+        }
+      end
 
-          'new_mandate' => 'new_mandate-input'
+      let!(:post_stub) do
+        stub_request(:post, %r{.*api.gocardless.com/mandates}).to_return(
+          body: {
+            error: {
+              type: 'invalid_state',
+              code: 409,
+              errors: [
+                {
+                  message: 'A resource has already been created with this idempotency key',
+                  reason: 'idempotent_creation_conflict',
+                  links: {
+                    conflicting_resource_id: id
+                  }
+                }
+              ]
+            }
+          }.to_json,
+          headers: response_headers,
+          status: 409
+        )
+      end
 
-        },
+      let!(:get_stub) do
+        stub_url = "/mandates/#{id}"
+        stub_request(:get, /.*api.gocardless.com#{stub_url}/)
+          .to_return(
+            body: {
+              'mandates' => {
+
+                'created_at' => 'created_at-input',
+                'id' => 'id-input',
+                'links' => 'links-input',
+                'metadata' => 'metadata-input',
+                'next_possible_charge_date' => 'next_possible_charge_date-input',
+                'payments_require_approval' => 'payments_require_approval-input',
+                'reference' => 'reference-input',
+                'scheme' => 'scheme-input',
+                'status' => 'status-input'
+              }
+            }.to_json,
+            headers: response_headers
+          )
+      end
 
-        'metadata' => 'metadata-input',
+      it 'fetches the already-created resource' do
+        post_create_response
+        expect(post_stub).to have_been_requested
+        expect(get_stub).to have_been_requested
+      end
+    end
+  end
 
-        'next_possible_charge_date' => 'next_possible_charge_date-input',
+  describe '#list' do
+    describe 'with no filters' do
+      subject(:get_list_response) { client.mandates.list }
+
+      before do
+        stub_request(:get, %r{.*api.gocardless.com/mandates}).to_return(
+          body: {
+            'mandates' => [{
+
+              'created_at' => 'created_at-input',
+              'id' => 'id-input',
+              'links' => 'links-input',
+              'metadata' => 'metadata-input',
+              'next_possible_charge_date' => 'next_possible_charge_date-input',
+              'payments_require_approval' => 'payments_require_approval-input',
+              'reference' => 'reference-input',
+              'scheme' => 'scheme-input',
+              'status' => 'status-input'
+            }],
+            meta: {
+              cursors: {
+                before: nil,
+                after: 'ABC123'
+              }
+            }
+          }.to_json,
+          headers: response_headers
+        )
+      end
+
+      it 'wraps each item in the resource class' do
+        expect(get_list_response.records.map(&:class).uniq.first).to eq(GoCardlessPro::Resources::Mandate)
+
+        expect(get_list_response.records.first.created_at).to eq('created_at-input')
+
+        expect(get_list_response.records.first.id).to eq('id-input')
 
-        'payments_require_approval' => 'payments_require_approval-input',
+        expect(get_list_response.records.first.metadata).to eq('metadata-input')
 
-        'reference' => 'reference-input',
+        expect(get_list_response.records.first.next_possible_charge_date).to eq('next_possible_charge_date-input')
 
-        'scheme' => 'scheme-input',
+        expect(get_list_response.records.first.payments_require_approval).to eq('payments_require_approval-input')
 
-        'status' => 'status-input'
+        expect(get_list_response.records.first.reference).to eq('reference-input')
+
+        expect(get_list_response.records.first.scheme).to eq('scheme-input')
+
+        expect(get_list_response.records.first.status).to eq('status-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
+
+      specify { expect(get_list_response.api_response.headers).to eql('content-type' => 'application/json') }
     end
+  end
 
-    it 'can be initialized from an unenveloped response' do
-      resource = described_class.new(data)
+  describe '#all' do
+    let!(:first_response_stub) do
+      stub_request(:get, %r{.*api.gocardless.com/mandates$}).to_return(
+        body: {
+          'mandates' => [{
+
+            'created_at' => 'created_at-input',
+            'id' => 'id-input',
+            'links' => 'links-input',
+            'metadata' => 'metadata-input',
+            'next_possible_charge_date' => 'next_possible_charge_date-input',
+            'payments_require_approval' => 'payments_require_approval-input',
+            'reference' => 'reference-input',
+            'scheme' => 'scheme-input',
+            'status' => 'status-input'
+          }],
+          meta: {
+            cursors: { after: 'AB345' },
+            limit: 1
+          }
+        }.to_json,
+        headers: response_headers
+      )
+    end
 
-      expect(resource.created_at).to eq('created_at-input')
+    let!(:second_response_stub) do
+      stub_request(:get, %r{.*api.gocardless.com/mandates\?after=AB345}).to_return(
+        body: {
+          'mandates' => [{
+
+            'created_at' => 'created_at-input',
+            'id' => 'id-input',
+            'links' => 'links-input',
+            'metadata' => 'metadata-input',
+            'next_possible_charge_date' => 'next_possible_charge_date-input',
+            'payments_require_approval' => 'payments_require_approval-input',
+            'reference' => 'reference-input',
+            'scheme' => 'scheme-input',
+            'status' => 'status-input'
+          }],
+          meta: {
+            limit: 2,
+            cursors: {}
+          }
+        }.to_json,
+        headers: response_headers
+      )
+    end
 
-      expect(resource.id).to eq('id-input')
+    it 'automatically makes the extra requests' do
+      expect(client.mandates.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.mandates.get(id) }
+
+    context 'passing in a custom header' do
+      let!(:stub) do
+        stub_url = '/mandates/:identity'.gsub(':identity', id)
+        stub_request(:get, /.*api.gocardless.com#{stub_url}/)
+          .with(headers: { 'Foo' => 'Bar' })
+          .to_return(
+            body: {
+              'mandates' => {
+
+                'created_at' => 'created_at-input',
+                'id' => 'id-input',
+                'links' => 'links-input',
+                'metadata' => 'metadata-input',
+                'next_possible_charge_date' => 'next_possible_charge_date-input',
+                'payments_require_approval' => 'payments_require_approval-input',
+                'reference' => 'reference-input',
+                'scheme' => 'scheme-input',
+                'status' => 'status-input'
+              }
+            }.to_json,
+            headers: response_headers
+          )
+      end
 
-      expect(resource.links.creditor).to eq('creditor-input')
+      subject(:get_response) do
+        client.mandates.get(id, headers: {
+                              'Foo' => 'Bar'
+                            })
+      end
+
+      it 'includes the header' do
+        get_response
+        expect(stub).to have_been_requested
+      end
+    end
 
-      expect(resource.links.customer).to eq('customer-input')
+    context 'when there is a mandate to return' do
+      before do
+        stub_url = '/mandates/:identity'.gsub(':identity', id)
+        stub_request(:get, /.*api.gocardless.com#{stub_url}/).to_return(
+          body: {
+            'mandates' => {
+
+              'created_at' => 'created_at-input',
+              'id' => 'id-input',
+              'links' => 'links-input',
+              'metadata' => 'metadata-input',
+              'next_possible_charge_date' => 'next_possible_charge_date-input',
+              'payments_require_approval' => 'payments_require_approval-input',
+              'reference' => 'reference-input',
+              'scheme' => 'scheme-input',
+              'status' => 'status-input'
+            }
+          }.to_json,
+          headers: response_headers
+        )
+      end
+
+      it 'wraps the response in a resource' do
+        expect(get_response).to be_a(GoCardlessPro::Resources::Mandate)
+      end
+    end
+
+    context 'when nothing is returned' do
+      before do
+        stub_url = '/mandates/:identity'.gsub(':identity', id)
+        stub_request(:get, /.*api.gocardless.com#{stub_url}/).to_return(
+          body: '',
+          headers: response_headers
+        )
+      end
 
-      expect(resource.links.customer_bank_account).to eq('customer_bank_account-input')
+      it 'returns nil' do
+        expect(get_response).to be_nil
+      end
+    end
 
-      expect(resource.links.new_mandate).to eq('new_mandate-input')
+    context "when an ID is specified which can't be included in a valid URI" do
+      let(:id) { '`' }
 
-      expect(resource.metadata).to eq('metadata-input')
+      it "doesn't raise an error" do
+        expect { get_response }.to_not raise_error(/bad URI/)
+      end
+    end
+  end
 
-      expect(resource.next_possible_charge_date).to eq('next_possible_charge_date-input')
+  describe '#update' do
+    subject(:put_update_response) { client.mandates.update(id, params: update_params) }
+    let(:id) { 'ABC123' }
+
+    context 'with a valid request' do
+      let(:update_params) { { 'hello' => 'world' } }
+
+      let!(:stub) do
+        stub_url = '/mandates/:identity'.gsub(':identity', id)
+        stub_request(:put, /.*api.gocardless.com#{stub_url}/).to_return(
+          body: {
+            'mandates' => {
+
+              'created_at' => 'created_at-input',
+              'id' => 'id-input',
+              'links' => 'links-input',
+              'metadata' => 'metadata-input',
+              'next_possible_charge_date' => 'next_possible_charge_date-input',
+              'payments_require_approval' => 'payments_require_approval-input',
+              'reference' => 'reference-input',
+              'scheme' => 'scheme-input',
+              'status' => 'status-input'
+            }
+          }.to_json,
+          headers: response_headers
+        )
+      end
 
-      expect(resource.payments_require_approval).to eq('payments_require_approval-input')
+      it 'updates and returns the resource' do
+        expect(put_update_response).to be_a(GoCardlessPro::Resources::Mandate)
+        expect(stub).to have_been_requested
+      end
+    end
+  end
 
-      expect(resource.reference).to eq('reference-input')
+  describe '#cancel' do
+    subject(:post_response) { client.mandates.cancel(resource_id) }
+
+    let(:resource_id) { 'ABC123' }
+
+    let!(:stub) do
+      # /mandates/%v/actions/cancel
+      stub_url = '/mandates/:identity/actions/cancel'.gsub(':identity', resource_id)
+      stub_request(:post, /.*api.gocardless.com#{stub_url}/).to_return(
+        body: {
+          'mandates' => {
+
+            'created_at' => 'created_at-input',
+            'id' => 'id-input',
+            'links' => 'links-input',
+            'metadata' => 'metadata-input',
+            'next_possible_charge_date' => 'next_possible_charge_date-input',
+            'payments_require_approval' => 'payments_require_approval-input',
+            'reference' => 'reference-input',
+            'scheme' => 'scheme-input',
+            'status' => 'status-input'
+          }
+        }.to_json,
+        headers: response_headers
+      )
+    end
 
-      expect(resource.scheme).to eq('scheme-input')
+    it 'wraps the response and calls the right endpoint' do
+      expect(post_response).to be_a(GoCardlessPro::Resources::Mandate)
 
-      expect(resource.status).to eq('status-input')
+      expect(stub).to have_been_requested
     end
 
-    it 'can handle new attributes without erroring' do
-      data['foo'] = 'bar'
-      expect { described_class.new(data) }.to_not raise_error
+    context 'when the request needs a body and custom header' do
+      let(:body) { { foo: 'bar' } }
+      let(:headers) { { 'Foo' => 'Bar' } }
+      subject(:post_response) { client.mandates.cancel(resource_id, body, headers) }
+
+      let(:resource_id) { 'ABC123' }
+
+      let!(:stub) do
+        # /mandates/%v/actions/cancel
+        stub_url = '/mandates/: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: {
+              'mandates' => {
+
+                'created_at' => 'created_at-input',
+                'id' => 'id-input',
+                'links' => 'links-input',
+                'metadata' => 'metadata-input',
+                'next_possible_charge_date' => 'next_possible_charge_date-input',
+                'payments_require_approval' => 'payments_require_approval-input',
+                'reference' => 'reference-input',
+                'scheme' => 'scheme-input',
+                'status' => 'status-input'
+              }
+            }.to_json,
+            headers: response_headers
+          )
+      end
     end
+  end
 
-    it 'can handle new link attributes without erroring' do
-      data['links']['foo'] = 'bar'
-      expect { described_class.new(data) }.to_not raise_error
+  describe '#reinstate' do
+    subject(:post_response) { client.mandates.reinstate(resource_id) }
+
+    let(:resource_id) { 'ABC123' }
+
+    let!(:stub) do
+      # /mandates/%v/actions/reinstate
+      stub_url = '/mandates/:identity/actions/reinstate'.gsub(':identity', resource_id)
+      stub_request(:post, /.*api.gocardless.com#{stub_url}/).to_return(
+        body: {
+          'mandates' => {
+
+            'created_at' => 'created_at-input',
+            'id' => 'id-input',
+            'links' => 'links-input',
+            'metadata' => 'metadata-input',
+            'next_possible_charge_date' => 'next_possible_charge_date-input',
+            'payments_require_approval' => 'payments_require_approval-input',
+            'reference' => 'reference-input',
+            'scheme' => 'scheme-input',
+            'status' => 'status-input'
+          }
+        }.to_json,
+        headers: response_headers
+      )
     end
 
-    it 'can handle a nil links value' do
-      data['links'] = nil
-      expect { described_class.new(data).links }.to_not raise_error
+    it 'wraps the response and calls the right endpoint' do
+      expect(post_response).to be_a(GoCardlessPro::Resources::Mandate)
+
+      expect(stub).to have_been_requested
     end
 
-    describe '#to_h' do
-      it 'returns a hash representing the resource' do
-        expect(described_class.new(data).to_h).to eq(data)
+    context 'when the request needs a body and custom header' do
+      let(:body) { { foo: 'bar' } }
+      let(:headers) { { 'Foo' => 'Bar' } }
+      subject(:post_response) { client.mandates.reinstate(resource_id, body, headers) }
+
+      let(:resource_id) { 'ABC123' }
+
+      let!(:stub) do
+        # /mandates/%v/actions/reinstate
+        stub_url = '/mandates/:identity/actions/reinstate'.gsub(':identity', resource_id)
+        stub_request(:post, /.*api.gocardless.com#{stub_url}/)
+          .with(
+            body: { foo: 'bar' },
+            headers: { 'Foo' => 'Bar' }
+          ).to_return(
+            body: {
+              'mandates' => {
+
+                'created_at' => 'created_at-input',
+                'id' => 'id-input',
+                'links' => 'links-input',
+                'metadata' => 'metadata-input',
+                'next_possible_charge_date' => 'next_possible_charge_date-input',
+                'payments_require_approval' => 'payments_require_approval-input',
+                'reference' => 'reference-input',
+                'scheme' => 'scheme-input',
+                'status' => 'status-input'
+              }
+            }.to_json,
+            headers: response_headers
+          )
       end
     end
   end