affirm 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 689c049744aaff6ed260bd43c0bcdf0219e6689a
+  data.tar.gz: 90142f082b195d4b12b593ba8dbe8f0a9d0a01b1
+SHA512:
+  metadata.gz: 6b0c3a679864712c47a0053eff6135b0fc2ba4c6a24cb49f9d66b019c95b1ca3b724f2eff90d0a4a8e07f46a5654c8667b44a9e87edbb3d817995b25eca1369b
+  data.tar.gz: 0836887d3303dbb09d741b13e8894b5f6ec7c987c8218cc1a744e053b4b99a86fb440a14ecb93ba9aabb80051fab200833c211ff7d0e3071d54c35e6c84110a4

data/README.md

@@ -0,0 +1,125 @@
+# affirm-ruby
+Ruby client library for integrating with Affirm financing (https://www.affirm.com/)
+
+Requires Ruby 2.1 or greater.
+
+[![Build Status](https://travis-ci.org/reverbdotcom/affirm-ruby.png?branch=master)](https://travis-ci.org/reverbdotcom/affirm-ruby)
+
+## Install
+Add to your gemfile:
+```ruby
+gem 'affirm-ruby'
+```
+and `bundle install`.
+
+*Note*: This gem is not yet registered with Rubygems. In the meantime, you can use the 'git' option in your Gemfile.
+
+## Initialize
+Initialize the client with your credentials (if you're using rails, this goes in `config/initializers`).
+```ruby
+Affirm::API.public_key = "xxx"
+Affirm::API.secret_key = "xxx"
+Affirm::API.api_url    = "https://sandbox.affirm.com/api/v2/"
+```
+
+## Charges
+The charges resource can be accessed through the api class:
+```ruby
+Affirm::API.charges
+```
+
+### Authorizing a charge
+```ruby
+Affirm::API.charges.authorize(checkout_token: "token")
+Affirm::API.charges.authorize!(checkout_token: "token") # raises Affirm::Error on failure
+```
+
+### Reading a charge
+```ruby
+Affirm::API.charges.get(charge_id: "abcd")
+```
+
+### Capturing a charge
+Optionally takes an `order_id`, `shipping_carrier`, and `shipping_confirmation`.
+```ruby
+Affirm::API.charges.capture(charge_id: "abcd")
+Affirm::API.charges.capture(charge_id: "abcd", order_id: "1234", shipping_carrier: "USPS", shipping_confirmation: "ABCD1234")
+Affirm::API.charges.capture!(charge_id: "abcd") # raises Affirm::Error on failure
+```
+
+### Voiding a charge
+```ruby
+Affirm::API.charges.void(charge_id: "abcd")
+Affirm::API.charges.void!(charge_id: "abcd") # raises Affirm::Error on failure
+```
+
+### Refunding a charge
+Optionally takes an `amount` to refund (in cents).
+```ruby
+Affirm::API.charges.refund(charge_id: "abcd")
+Affirm::API.charges.refund(charge_id: "abcd", amount: 5000)
+Affirm::API.charges.refund!(charge_id: "abcd") # raises Affirm::Error on failure
+```
+
+### Updating tracking fields
+Optionally takes an `order_id`, `shipping_carrier`, and `shipping_confirmation`.
+```ruby
+Affirm::API.charges.update(charge_id: "abcd", order_id: "1234", shipping_carrier: "USPS", shipping_confirmation: "ABCD1234")
+Affirm::API.charges.update!(charge_id: "abcd", order_id: "1234") # raises Affirm::Error on failure
+```
+
+## Responses
+On successful api calls, the response json is 
+```ruby
+response = Affirm::API.charges.get(charge_id: "abcd")
+
+response.success? # => true
+response.error? # => false
+
+response.status_code # => 200
+
+response.body # => hash of values
+response.body["id"] # eg "abcd"
+response.body["details"]["shipping_amount"] # eg 400
+```
+
+### Error responses
+Unsuccessful responses have a few methods built in:
+```ruby
+response.code # eg "auth-declined"
+response.type # eg "invalid_request"
+response.message # eg "Invalid phone number format"
+response.field # eg "shipping_address.phone"
+```
+See https://docs.affirm.com/v2/api/errors/#error-object.
+
+### Exceptions
+Exceptions are raised for 5xx, 404 and 401 responses, yielding an `Affirm::ServerError`,
+`Affirm::ResourceNotFoundError` and `Affirm::AuthenticationError`, respectively. These are subclassed from
+`Affirm::Error`.
+```ruby
+begin
+  Affirm::API.charges.authorize(checkout_token: "token")
+rescue Affirm::ServerError => e
+  Logger.info e.code
+  Logger.info e.message
+end
+```
+
+## Running specs
+After bundling, run `bundle exec rspec` to run the tests.
+
+## License
+Copyright 2015 Reverb.com, LLC
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/affirm.gemspec

@@ -0,0 +1,18 @@
+Gem::Specification.new do |s|
+  s.name = "affirm"
+  s.summary = "Affirm Ruby Client Library"
+  s.description = "Ruby client library for integrating with Affirm financing payments"
+  s.version = "0.0.1"
+  s.license = "Apache License Version 2.0"
+  s.author = "Reverb.com"
+  s.email = "dev@reverb.com"
+  s.has_rdoc = false
+  s.files = Dir.glob ["README.md", "lib/**/*.{rb}", "spec/**/*", "*.gemspec"]
+
+  s.add_dependency "typhoeus"
+
+  s.add_development_dependency "bundler"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec", "3.2.0"
+  s.add_development_dependency "webmock", "1.21.0"
+end

data/lib/affirm/api.rb

@@ -0,0 +1,20 @@
+module Affirm
+  class API
+    class << self
+      attr_accessor :public_key, :secret_key, :api_url
+      @@client = nil
+
+      def charges
+        @@charges ||= Affirm::Charges.new(client)
+      end
+
+      def client
+        @@client ||= Affirm::Client.new(
+          public_key: public_key,
+          secret_key: secret_key,
+          api_url: api_url
+        )
+      end
+    end
+  end
+end

data/lib/affirm/charges.rb

@@ -0,0 +1,103 @@
+module Affirm
+  class Charges
+    def initialize(client)
+      @client = client
+      @namespace = "charges"
+    end
+
+    ######
+    # GET
+    #
+    def get(charge_id:)
+      make_request(charge_id, :get)
+    end
+
+    ######
+    # AUTHORIZE
+    #
+    # checkout_token - (required) string. The charge token passed through the confirmation response.
+    def authorize(checkout_token:)
+      make_request("/", :post, checkout_token: checkout_token)
+    end
+
+    def authorize!(checkout_token:)
+      response = authorize(checkout_token: checkout_token)
+      assert_success(response)
+    end
+
+    ######
+    # CAPTURE
+    #
+    # order_id - (optional) string. Your internal order id. This is stored for your own future reference.
+    # shipping_carrier - (optional) string. The shipping carrier used to ship the items in the charge.
+    # shipping_confirmation - (optional) string. The shipping confirmation for the shipment.
+    def capture(charge_id:, order_id: nil, shipping_carrier: nil, shipping_confirmation: nil)
+      make_request("#{charge_id}/capture", :post, {
+        order_id: order_id,
+        shipping_carrier: shipping_carrier,
+        shipping_confirmation: shipping_confirmation
+      })
+    end
+
+    def capture!(charge_id:, order_id: nil, shipping_carrier: nil, shipping_confirmation: nil)
+      response = capture(charge_id: charge_id, order_id: order_id, shipping_carrier: shipping_carrier, shipping_confirmation: shipping_confirmation)
+      assert_success(response)
+    end
+
+    ######
+    # VOID
+    #
+    def void(charge_id:)
+      make_request("#{charge_id}/void", :post)
+    end
+
+    def void!(charge_id:)
+      response = void(charge_id: charge_id)
+      assert_success(response)
+    end
+
+    ######
+    # REFUND
+    #
+    # amount - (optional) integer or null. The amount to refund in cents. The default amount is the remaining balance on the charge.
+    def refund(charge_id:, amount: nil)
+      make_request("#{charge_id}/refund", :post, amount: amount)
+    end
+
+    def refund!(charge_id:, amount: nil)
+      response = refund(charge_id: charge_id, amount: amount)
+      assert_success(response)
+    end
+
+    ######
+    # UPDATE
+    #
+    # order_id - (optional) string. Your internal order id. This is stored for your own future reference.
+    # shipping_carrier - (optional) string. The shipping carrier used to ship the items in the charge.
+    # shipping_confirmation - (optional) string. The shipping confirmation for the shipment.
+    def update(charge_id:, order_id: nil, shipping_carrier: nil, shipping_confirmation: nil)
+      make_request("#{charge_id}/update", :post, {
+        order_id: order_id,
+        shipping_carrier: shipping_carrier,
+        shipping_confirmation: shipping_confirmation
+      })
+    end
+
+    def update!(charge_id:, order_id: nil, shipping_carrier: nil, shipping_confirmation: nil)
+      response = update(charge_id: charge_id, order_id: order_id, shipping_carrier: shipping_carrier, shipping_confirmation: shipping_confirmation)
+      assert_success(response)
+    end
+
+    private
+
+    def make_request(path, method, data={})
+      @client.make_request(File.join(@namespace, path), method, data)
+    end
+
+    def assert_success(response)
+      raise Affirm::Error.from_response(response) if response.error?
+
+      response
+    end
+  end
+end

data/lib/affirm/client.rb

@@ -0,0 +1,69 @@
+module Affirm
+  class Client
+    def initialize(public_key:, secret_key:, api_url: Affirm::API.api_url)
+      @public_key = public_key
+      @secret_key = secret_key
+      @api_url = api_url
+    end
+
+    def post(path, data={})
+      make_request(path, :post, data)
+    end
+
+    def get(path, data={})
+      make_request(path, :get, data)
+    end
+
+    def make_request(path, method, data={})
+      response = Typhoeus::Request.new(
+        url(path),
+        method: method,
+        body: data.to_json,
+        headers: affirm_headers(data),
+        userpwd: user_password
+      ).run
+
+      affirm_response = parse_response(response)
+
+      handle_errors(affirm_response)
+    end
+
+    private
+
+    def parse_response(response)
+      Affirm::Response.new(
+        success: response.success?,
+        status_code: response.code,
+        body: response.body
+      )
+    end
+
+    def handle_errors(affirm_response)
+      if affirm_response.status_code == 401
+        raise_error(Affirm::AuthenticationError, affirm_response)
+      elsif affirm_response.status_code == 404
+        raise_error(Affirm::ResourceNotFoundError, affirm_response)
+      elsif affirm_response.status_code >= 500
+        raise_error(Affirm::ServerError, affirm_response)
+      end
+
+      affirm_response
+    end
+
+    def raise_error(error_class, affirm_response)
+      raise error_class.from_response(affirm_response)
+    end
+
+    def affirm_headers(data)
+      { "Content-Type" => "application/json" } if data.length > 0
+    end
+
+    def user_password
+      "#{@public_key}:#{@secret_key}"
+    end
+
+    def url(path)
+      File.join(@api_url, path)
+    end
+  end
+end

data/lib/affirm/errors/authentication_error.rb

@@ -0,0 +1,3 @@
+module Affirm
+  class AuthenticationError < Error; end
+end

data/lib/affirm/errors/error.rb

@@ -0,0 +1,23 @@
+module Affirm
+  class Error < RuntimeError
+    attr_reader :status_code, :code, :message
+
+    def self.from_response(response)
+      new(
+        status_code: response.status_code,
+        code:        response.code,
+        message:     response.message
+      )
+    end
+
+    def initialize(status_code:, code:, message:)
+      @status_code = status_code
+      @code = code
+      @message = message
+    end
+
+    def to_s
+      "#{status_code} #{code}: #{message}"
+    end
+  end
+end

data/lib/affirm/errors/resource_not_found_error.rb

@@ -0,0 +1,3 @@
+module Affirm
+  class ResourceNotFoundError < Error; end
+end

data/lib/affirm/errors/server_error.rb

@@ -0,0 +1,3 @@
+module Affirm
+  class ServerError < Error; end
+end

data/lib/affirm/response.rb

@@ -0,0 +1,39 @@
+module Affirm
+  class Response
+    attr_reader :status_code
+
+    def initialize(success:, status_code:, body:)
+      @success = success
+      @status_code = status_code.to_i
+      @body = body
+    end
+
+    def success?
+      @success
+    end
+
+    def error?
+      !success?
+    end
+
+    def body
+      JSON.parse(@body)
+    end
+
+    def type
+      body["type"]
+    end
+
+    def code
+      body["code"]
+    end
+
+    def message
+      body["message"]
+    end
+
+    def field
+      body["field"]
+    end
+  end
+end

data/lib/affirm.rb

@@ -0,0 +1,11 @@
+require 'json'
+
+require 'affirm/api'
+require 'affirm/client'
+require 'affirm/response'
+require 'affirm/charges'
+
+require 'affirm/errors/error'
+require 'affirm/errors/authentication_error'
+require 'affirm/errors/resource_not_found_error'
+require 'affirm/errors/server_error'

data/spec/charges_spec.rb

@@ -0,0 +1,170 @@
+require 'spec_helper'
+
+describe Affirm::Charges do
+  let!(:request) do
+    stub_request(request_method, request_url).to_return(status: response_code, body: response_body)
+  end
+
+  let(:response_code) { 200 }
+
+  describe "self.get" do
+    let(:request_method) { :get }
+    let(:request_url) { "#{TEST_URL}/charges/ABCD" }
+    let(:response_body) { load_fixture("charges/get.json") }
+
+    it "is successful" do
+      response = Affirm::API.charges.get(charge_id: "ABCD")
+      response.should be_success
+      response.body["amount"].should == 6100
+    end
+  end
+
+  describe "self.authorize" do
+    let(:request_method) { :post }
+    let(:request_url) { "#{TEST_URL}/charges/" }
+    let(:response_body) { load_fixture("charges/authorize.json") }
+
+    it "is successful" do
+      response = Affirm::API.charges.authorize(checkout_token: "token")
+      response.should be_success
+    end
+
+    it "sends the correct body" do
+      Affirm::API.charges.authorize(checkout_token: "token")
+
+      expect(WebMock).to have_requested(request_method, request_url).with(body: {
+        checkout_token: "token"
+      }.to_json)
+    end
+
+    context "bang method" do
+      let(:response_code) { 422 }
+      let(:response_body) { load_fixture("charges/invalid_request.json") }
+
+      it "raises an error on failure" do
+        expect { Affirm::API.charges.authorize!(checkout_token: "token") }.to raise_error(Affirm::Error)
+      end
+    end
+  end
+
+  describe "self.capture" do
+    let(:request_method) { :post }
+    let(:request_url) { "#{TEST_URL}/charges/ABCD/capture" }
+    let(:response_body) { load_fixture("charges/capture.json") }
+
+    it "is successful" do
+      response = Affirm::API.charges.capture(charge_id: "ABCD")
+      response.should be_success
+    end
+
+    it "optionally allows tracking params" do
+      params = { order_id: "order_id", shipping_carrier: "carrier", shipping_confirmation: "confirmation" }
+      Affirm::API.charges.capture({charge_id: "ABCD"}.merge(params))
+
+      expect(WebMock).to have_requested(request_method, request_url).with(body: params.to_json)
+    end
+
+    context "bang method" do
+      let(:response_code) { 422 }
+      let(:response_body) { load_fixture("charges/invalid_request.json") }
+
+      it "raises an error on failure" do
+        expect { Affirm::API.charges.capture!(charge_id: "ABCD") }.to raise_error(Affirm::Error)
+      end
+    end
+  end
+
+  describe "self.void" do
+    let(:request_method) { :post }
+    let(:request_url) { "#{TEST_URL}/charges/ABCD/void" }
+    let(:response_body) { load_fixture("charges/void.json") }
+
+    it "is successful" do
+      response = Affirm::API.charges.void(charge_id: "ABCD")
+      response.should be_success
+    end
+
+    context "bang method" do
+      let(:response_code) { 422 }
+      let(:response_body) { load_fixture("charges/invalid_request.json") }
+
+      it "raises an error on failure" do
+        expect { Affirm::API.charges.void!(charge_id: "ABCD") }.to raise_error(Affirm::Error)
+      end
+    end
+  end
+
+  describe "self.refund" do
+    let(:request_method) { :post }
+    let(:request_url) { "#{TEST_URL}/charges/ABCD/refund" }
+    let(:response_body) { load_fixture("charges/refund.json") }
+
+    it "is successful" do
+      response = Affirm::API.charges.refund(charge_id: "ABCD")
+      response.should be_success
+    end
+
+    context "with amount" do
+      it "sends the correct body" do
+        Affirm::API.charges.refund(charge_id: "ABCD", amount: 100)
+
+        expect(WebMock).to have_requested(request_method, request_url).with(body: {
+          amount: 100
+        }.to_json)
+      end
+    end
+
+    context "bang method" do
+      let(:response_code) { 422 }
+      let(:response_body) { load_fixture("charges/invalid_request.json") }
+
+      it "raises an error on failure" do
+        expect { Affirm::API.charges.refund!(charge_id: "ABCD") }.to raise_error(Affirm::Error)
+      end
+    end
+  end
+
+  describe "self.update" do
+    let(:request_method) { :post }
+    let(:request_url) { "#{TEST_URL}/charges/ABCD/update" }
+    let(:response_body) { load_fixture("charges/update.json") }
+
+    it "is successful" do
+      response = Affirm::API.charges.update(charge_id: "ABCD", order_id: "order_id", shipping_carrier: "carrier", shipping_confirmation: "confirmation")
+      response.should be_success
+    end
+
+    it "sends the correct body" do
+      params = { order_id: "order_id", shipping_carrier: "carrier", shipping_confirmation: "confirmation" }
+      Affirm::API.charges.update({charge_id: "ABCD"}.merge(params))
+
+      expect(WebMock).to have_requested(request_method, request_url).with(body: params.to_json)
+    end
+
+    it "doesn't require the params" do
+      response = Affirm::API.charges.update(charge_id: "ABCD")
+      response.should be_success
+    end
+
+    context "bang method" do
+      let(:response_code) { 422 }
+      let(:response_body) { load_fixture("charges/invalid_request.json") }
+
+      it "raises an error on failure" do
+        expect { Affirm::API.charges.update!(charge_id: "ABCD") }.to raise_error(Affirm::Error)
+      end
+    end
+  end
+
+  context "with specified client" do
+    let(:client) { Affirm::Client.new(public_key: "other_public", secret_key: "other_secret") }
+
+    let(:request_method) { :get }
+    let(:response_body) { load_fixture("charges/get.json") }
+    let(:request_url) { /.*other_public:other_secret.*/ }
+
+    it "uses the client's creds" do
+      described_class.new(client).get(charge_id: "ABCD")
+    end
+  end
+end

data/spec/client_spec.rb

@@ -0,0 +1,141 @@
+require 'spec_helper'
+
+describe Affirm::Client do
+  let(:client) { described_class.new(public_key: public_key, secret_key: secret_key, api_url: api_url) }
+  let(:public_key) { "public_key" }
+  let(:secret_key) { "secret_key" }
+  let(:api_url) { "https://testaffirm.com" }
+
+  let(:request) { double("request", run: response) }
+  let(:response) { double("response", success?: true, body: "", code: 200) }
+  let(:affirm_url) { "https://public_key:secret_key@testaffirm.com/testpath" }
+
+  describe "make_request" do
+    before do
+      Typhoeus::Request.stub(:new) { request }
+    end
+
+    it "makes the request to the api url" do
+      client.make_request("testpath", :get)
+
+      Typhoeus::Request.should have_received(:new) do |url, options|
+        url.should == "https://testaffirm.com/testpath"
+        options[:method].should == :get
+      end
+
+      request.should have_received(:run)
+    end
+
+    it "sends keys as basic auth" do
+      client.make_request("testpath", :get)
+
+      Typhoeus::Request.should have_received(:new) do |url, options|
+        options[:userpwd].should == "public_key:secret_key"
+      end
+    end
+
+    context "with params" do
+      let(:params) { {"foo" => "bar"} }
+
+      it "sends the params" do
+        client.make_request("testpath", :post, params)
+
+        Typhoeus::Request.should have_received(:new) do |url, options|
+          options[:method].should == :post
+          JSON.parse(options[:body]).should == params
+        end
+      end
+
+      it "sets content type to application/json" do
+        client.make_request("testpath", :post, params)
+
+        Typhoeus::Request.should have_received(:new) do |url, options|
+          options[:headers]["Content-Type"].should == "application/json"
+        end
+      end
+    end
+
+    context "authentication error" do
+
+    end
+  end
+
+  describe "get" do
+    before do
+      Typhoeus::Request.stub(:new) { request }
+    end
+
+    it "sends a get request" do
+      client.get("testpath")
+
+      Typhoeus::Request.should have_received(:new) do |url, options|
+        options[:method].should == :get
+      end
+    end
+  end
+
+  describe "post" do
+    before do
+      Typhoeus::Request.stub(:new) { request }
+    end
+
+    it "sends a post request" do
+      client.post("testpath")
+
+      Typhoeus::Request.should have_received(:new) do |url, options|
+        options[:method].should == :post
+      end
+    end
+  end
+
+  describe "response" do
+    before do
+      stub_request(:get, affirm_url).
+        to_return(status: 200, body: {foo: "bar"}.to_json)
+    end
+
+    it "parses the response" do
+      response = client.get("testpath")
+
+      response.should be_a(Affirm::Response)
+      response.should be_success
+      response.status_code.should == 200
+      response.body["foo"].should == "bar"
+    end
+  end
+
+  describe "errors" do
+    context "authentication error" do
+      before do
+        stub_request(:get, affirm_url).
+          to_return(status: 401, body: {status_code: 401, type: "unauthorized", code: "public-api-key-invalid"}.to_json)
+      end
+
+      it "raises Affirm::AuthenticationError" do
+        expect { client.get("testpath") }.to raise_error(Affirm::AuthenticationError)
+      end
+    end
+
+    context "server error" do
+      before do
+        stub_request(:get, affirm_url).
+          to_return(status: 500, body: {status_code: 500}.to_json)
+      end
+
+      it "raises Affirm::ServerError" do
+        expect { client.get("testpath") }.to raise_error(Affirm::ServerError)
+      end
+    end
+
+    context "resource not found" do
+      before do
+        stub_request(:get, affirm_url).
+          to_return(status: 404, body: {status_code: 404}.to_json)
+      end
+
+      it "raises Affirm::ResourceNotFoundError" do
+        expect { client.get("testpath") }.to raise_error(Affirm::ResourceNotFoundError)
+      end
+    end
+  end
+end

data/spec/fixtures/charges/authorize.json

@@ -0,0 +1,45 @@
+{
+   "id":"TEST-ALO4-UVGR",
+   "created":"2014-03-18T19:19:04Z",
+   "currency":"USD",
+   "amount":6100,
+   "auth_hold":6100,
+   "payable":0,
+   "void":false,
+   "events":[
+      {
+         "created":"2014-03-20T14:00:33Z",
+         "currency":"USD",
+         "id":"UI1ZOXSXQ44QUXQL",
+         "transaction_id":"TpR3Xrx8TkvuGio0",
+         "type":"auth"
+      }
+   ],
+   "details":{
+      "items":{
+         "sweater-a92123":{
+            "sku":"sweater-a92123",
+            "display_name":"Sweater",
+            "qty":1,
+            "item_type":"physical",
+            "item_image_url":"http://placehold.it/350x150",
+            "item_url":"http://placehold.it/350x150",
+            "unit_price":5000
+         }
+      },
+      "shipping_amount":400,
+      "tax_amount":700,
+      "shipping":{
+         "name":{
+            "full":"John Doe"
+         },
+         "address":{
+            "line1":"325 Pacific Ave",
+            "city":"San Francisco",
+            "state":"CA",
+            "zipcode":"94112",
+            "country":"USA"
+         }
+      }
+   }
+}

data/spec/fixtures/charges/capture.json

@@ -0,0 +1,8 @@
+{
+  "type": "capture",
+  "created": "2014-03-18T19:19:04Z",
+  "amount": 500,
+  "fee": 15,
+  "id": "JAPP6MISWXVA4OQ5",
+  "transaction_id": "9qkLbxrtEJG0ImEQ"
+}

data/spec/fixtures/charges/get.json

@@ -0,0 +1,45 @@
+{
+   "id":"TEST-ALO4-UVGR",
+   "created":"2014-03-18T19:19:04Z",
+   "currency":"USD",
+   "amount":6100,
+   "auth_hold":6100,
+   "payable":0,
+   "void":false,
+   "events":[
+      {
+         "created":"2014-03-20T14:00:33Z",
+         "currency":"USD",
+         "id":"UI1ZOXSXQ44QUXQL",
+         "transaction_id":"TpR3Xrx8TkvuGio0",
+         "type":"auth"
+      }
+   ],
+   "details":{
+      "items":{
+         "sweater-a92123":{
+            "sku":"sweater-a92123",
+            "display_name":"Sweater",
+            "qty":1,
+            "item_type":"physical",
+            "item_image_url":"http://placehold.it/350x150",
+            "item_url":"http://placehold.it/350x150",
+            "unit_price":5000
+         }
+      },
+      "shipping_amount":400,
+      "tax_amount":700,
+      "shipping":{
+         "name":{
+            "full":"John Doe"
+         },
+         "address":{
+            "line1":"325 Pacific Ave",
+            "city":"San Francisco",
+            "state":"CA",
+            "zipcode":"94112",
+            "country":"USA"
+         }
+      }
+   }
+}

data/spec/fixtures/charges/invalid_request.json

@@ -0,0 +1,5 @@
+{
+  "status_code": 422,
+  "type": "invalid_request",
+  "code": "test-code"
+}

data/spec/fixtures/charges/refund.json

@@ -0,0 +1,8 @@
+{
+  "created": "2014-03-18T19:20:30Z",
+  "fee_refunded": 15,
+  "amount": 500,
+  "type": "refund",
+  "id": "OWA49MWUCA29SBVQ",
+  "transaction_id": "r86zdkHONPcaiVJJ"
+}

data/spec/fixtures/charges/update.json

@@ -0,0 +1,7 @@
+{
+  "created": "2014-10-08T23:48:04Z",
+  "id": "DCPO5PP6QA9V7T60",
+  "order_id": "CUSTOM_ORDER_ID",
+  "shipping_carrier": "USPS",
+  "shipping_confirmation": "1Z23223"
+}

data/spec/fixtures/charges/void.json

@@ -0,0 +1,6 @@
+{
+  "type": "void",
+  "id": "N5E9OXSIDJ8TKZZ9",
+  "transaction_id": "G9TqohxBlRPWTGB2",
+  "created": "2014-03-17T22:52:16Z"
+}

data/spec/spec_helper.rb

@@ -0,0 +1,38 @@
+require 'webmock'
+require 'webmock/rspec'
+require 'affirm'
+
+include WebMock::API
+
+TEST_URL = "https://public_key:secret_key@test.affirm.com"
+
+RSpec.configure do |config|
+  config.before(:suite) do
+    Affirm::API.public_key = "public_key"
+    Affirm::API.secret_key = "secret_key"
+    Affirm::API.api_url    = "https://test.affirm.com"
+  end
+
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+    expectations.syntax = [:should, :expect]
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+    mocks.syntax = [:should, :expect]
+  end
+
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  if config.files_to_run.one?
+    config.default_formatter = 'doc'
+  end
+
+  config.order = :random
+end
+
+def load_fixture(path)
+  File.read(File.join(__dir__, "fixtures", path))
+end

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: affirm
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Reverb.com
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+description: Ruby client library for integrating with Affirm financing payments
+email: dev@reverb.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- affirm.gemspec
+- lib/affirm.rb
+- lib/affirm/api.rb
+- lib/affirm/charges.rb
+- lib/affirm/client.rb
+- lib/affirm/errors/authentication_error.rb
+- lib/affirm/errors/error.rb
+- lib/affirm/errors/resource_not_found_error.rb
+- lib/affirm/errors/server_error.rb
+- lib/affirm/response.rb
+- spec/charges_spec.rb
+- spec/client_spec.rb
+- spec/fixtures/charges/authorize.json
+- spec/fixtures/charges/capture.json
+- spec/fixtures/charges/get.json
+- spec/fixtures/charges/invalid_request.json
+- spec/fixtures/charges/refund.json
+- spec/fixtures/charges/update.json
+- spec/fixtures/charges/void.json
+- spec/spec_helper.rb
+homepage: 
+licenses:
+- Apache License Version 2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Affirm Ruby Client Library
+test_files: []