paymentrails-zero 0.2.13

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 502087c7ed2ea4e06131cff8de78c72bae589bcf42d8ea4f88079c1fbb72e44c
+  data.tar.gz: 61aaf4ca7f89590eea3a6e68676b0747cfc56d7610880374621fb31401badb3e
+SHA512:
+  metadata.gz: 655f04d7146ad8d723ea75628a410558746a9067433b917c97a7de482a11a96272197e377b74fd63c18657043ca3dec311161be40a9feaef251a23604e950928
+  data.tar.gz: 9ad7ae74c3b120ed3bcbdb65921dedb708a3b30e24f74c70253d61822c9a3aeafc4badd24059504c361a916c52edd608b7a282e084a95922231f73f973bb4733

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2017 Trolley, Inc.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/lib/paymentrails/Balance.rb

@@ -0,0 +1,4 @@
+module PaymentRails
+  class Balance
+  end
+end

data/lib/paymentrails/Batch.rb

@@ -0,0 +1,20 @@
+module PaymentRails
+  class Batch
+    attr_accessor(
+      :id,
+      :amount,
+      :completedAt,
+      :createdAt,
+      :currency,
+      :description,
+      :sentAt,
+      :status,
+      :totalPayments,
+      :updatedAt,
+      :quoteExpiredAt,
+      :payments,
+      :tags,
+      :coverFees
+    )
+  end
+end

data/lib/paymentrails/BatchSummary.rb

@@ -0,0 +1,21 @@
+module PaymentRails
+  class BatchSummary
+    attr_accessor(
+      :id,
+      :amount,
+      :completedAt,
+      :createdAt,
+      :currency,
+      :description,
+      :sentAt,
+      :status,
+      :totalPayments,
+      :updatedAt,
+      :methods,
+      :detail,
+      :total,
+      :balances,
+      :accounts
+    )
+  end
+end

data/lib/paymentrails/Client.rb

@@ -0,0 +1,100 @@
+# require_relative 'Exceptions.rb'
+require 'digest'
+require 'net/http'
+require 'openssl'
+require 'uri'
+require 'json'
+require "rubygems"
+
+module PaymentRails
+  class Client
+    def initialize(config)
+      @config = config
+    end
+
+    def get(endPoint)
+      send_request(endPoint, 'GET')
+    end
+
+    def post(endPoint, body)
+      body = body.to_json
+      send_request(endPoint, 'POST', body)
+    end
+
+    def delete(endPoint)
+      send_request(endPoint, 'DELETE')
+    end
+
+    def patch(endPoint, body)
+      body = body.to_json
+      send_request(endPoint, 'PATCH', body)
+    end
+
+    private
+
+    def send_request(endPoint, method, body = '')
+      uri = URI.parse(@config.apiBase + endPoint)
+      http = Net::HTTP.new(
+        uri.host, uri.port,
+        @config.proxy&.host, @config.proxy&.port, @config.proxy&.user, @config.proxy&.password
+      )
+      http.use_ssl = @config.useSsl?
+
+      spec = Gem::Specification.load("paymentrails.gemspec")
+
+      time = Time.now.to_i
+      headers = {'X-PR-Timestamp': time.to_s,
+                'Authorization': generate_authorization(time, endPoint, method, body),
+                'Content-Type': 'application/json',
+                'Trolley-Source': "ruby-sdk_#{spec.version}"}
+                
+      if method === "GET"
+        request = Net::HTTP::Get.new(uri.request_uri, headers)
+      elsif method === "POST"
+        request = Net::HTTP::Post.new(uri.request_uri, headers)
+        request.body = body
+      elsif method === "PATCH"
+        request = Net::HTTP::Patch.new(uri.request_uri, headers)
+        request.body = body
+      elsif method === "DELETE"
+        request = Net::HTTP::Delete.new(uri.request_uri, headers)
+      end
+
+      response = http.request(request)
+
+      if response.code != '200' && response.code != '204'
+        throw_status_code_exception(response.message + ' ' + response.body , response.code)
+      end
+      response.body
+    end
+
+    private
+    def generate_authorization(time, endPoint, method, body)
+      message = [time.to_s, method, endPoint, body].join("\n") + "\n"
+      signature = OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), @config.privateKey, message)
+      'prsign ' + @config.publicKey + ':' + signature
+    end
+
+    private
+    def throw_status_code_exception(message, code)
+        case code
+        when '400'
+          raise MalformedException, message
+        when '401'
+          raise AuthenticationError, message
+        when '403'
+          raise AuthorizationError, message
+        when '404'
+          raise NotFoundError, message
+        when '429'
+          raise TooManyRequestsError, message
+        when '500'
+          raise ServerError, message
+        when '503'
+          raise DownForMaintenanceError, message
+        else
+          raise UnexpectedError, message
+        end
+    end
+  end
+end

data/lib/paymentrails/Configuration.rb

@@ -0,0 +1,48 @@
+module PaymentRails
+  class Configuration
+    class InvalidProxyAddress < StandardError; end
+
+    def initialize(publicKey, privateKey, environment = 'production', proxy_uri: nil)
+      raise ArgumentError, 'Both key/secret must be a nonempty string' if publicKey.to_s&.empty? || privateKey.to_s&.empty?
+
+      @publicKey = publicKey
+      @privateKey = privateKey
+      @environment = environment
+      # failfast on a bad proxy
+      begin
+        @proxy = proxy_uri.nil? ? nil : URI.parse(proxy_uri)
+      rescue URI::InvalidURIError
+        raise InvalidProxyAddress, "Invalid proxy provided to configuration: #{proxy_uri}"
+      end
+    end
+
+    def apiBase
+      case environment
+      when 'production'
+        'https://api.trolley.com'
+      when 'development'
+        'https://api.railz.io'
+      when 'integration'
+        'http://api.local.dev:3000'
+      else
+        'https://api.trolley.com'
+      end
+    end
+
+    def useSsl?
+      apiBase.start_with? 'https'
+    end
+
+    attr_reader :proxy
+
+    attr_reader :publicKey
+
+    attr_writer :publicKey
+
+    attr_reader :privateKey
+
+    attr_writer :privateKey
+
+    attr_reader :environment
+  end
+end

data/lib/paymentrails/Exceptions.rb

@@ -0,0 +1,19 @@
+module PaymentRails
+    class PaymentRailsError < ::StandardError; end
+
+    class AuthenticationError < PaymentRailsError; end
+
+    class AuthorizationError < PaymentRailsError; end
+
+    class DownForMaintenanceError < PaymentRailsError; end
+
+    class NotFoundError < PaymentRailsError; end
+
+    class ServerError < PaymentRailsError; end
+
+    class TooManyRequestsError < PaymentRailsError; end
+
+    class UnexpectedError < PaymentRailsError; end
+
+    class MalformedException < PaymentRailsError; end
+end

data/lib/paymentrails/Gateway.rb

@@ -0,0 +1,43 @@
+module PaymentRails
+  class Gateway
+    attr_reader :config
+    attr_writer :config
+
+    attr_reader :client
+    attr_writer :client
+
+    attr_reader :recipient
+    attr_writer :recipient
+
+    attr_reader :recipient_account
+    attr_writer :recipient_account
+
+    attr_reader :batch
+    attr_writer :batch
+
+    attr_reader :payment
+    attr_writer :payment
+
+    attr_reader :balance
+    attr_writer :balance
+
+    attr_reader :offline_payment
+    attr_writer :offline_payment
+
+    attr_accessor :invoice
+    attr_accessor :invoice_payment
+
+    def initialize(config)
+      @config = config
+      @client = Client.new(config)
+      @recipient = RecipientGateway.new(client)
+      @recipient_account = RecipientAccountGateway.new(client)
+      @batch = BatchGateway.new(client)
+      @payment = PaymentGateway.new(client)
+      @balance = BalanceGateway.new(client)
+      @offline_payment = OfflinePaymentGateway.new(client)
+      @invoice = InvoiceGateway.new(client)
+      @invoice_payment = InvoicePaymentGateway.new(client)
+    end
+  end
+end

data/lib/paymentrails/Invoice.rb

@@ -0,0 +1,22 @@
+module PaymentRails
+  class Invoice
+    attr_accessor(
+      :id,
+      :description,
+      :externalId,
+      :invoiceDate,
+      :dueDate,
+      :invoiceNumber,
+      :status,
+      :releaseAfter,
+      :createdAt,
+      :updatedAt,
+      :totalAmount,
+      :paidAmount,
+      :dueAmount,
+      :tags,
+      :recipientId,
+      :lines
+    )
+  end
+end

data/lib/paymentrails/InvoicePayment.rb

@@ -0,0 +1,13 @@
+module PaymentRails
+  class InvoicePayment
+    attr_accessor(
+      :id,
+      :batchId,
+      :paymentId,
+      :invoiceId,
+      :invoiceLineId,
+      :amount,
+      :invoicePayments
+    )
+  end
+end

data/lib/paymentrails/OfflinePayment.rb

@@ -0,0 +1,23 @@
+module PaymentRails
+  class OfflinePayment
+    attr_accessor(
+      :id,
+      :recipientId,
+      :externalId,
+      :memo,
+      :tags,
+      :taxReportable,
+      :category,
+      :amount,
+      :currency,
+      :withholdingAmount,
+      :withholdingCurrency,
+      :processedAt,
+      :equivalentWithholdingAmount,
+      :equivalentWithholdingCurrency,
+      :updatedAt,
+      :createdAt,
+      :deletedAt
+    )
+  end
+end

data/lib/paymentrails/Payment.rb

@@ -0,0 +1,52 @@
+module PaymentRails
+  class Payment
+    attr_accessor(
+      :id,
+      :status,
+      :isSupplyPayment,
+      :returnedAmount,
+      :sourceAmount,
+      :sourceCurrency,
+      :targetAmount,
+      :targetCurrency,
+      :exchangeRate,
+      :fees,
+      :recipientFees,
+      :fxRate,
+      :memo,
+      :externalId,
+      :processedAt,
+      :createdAt,
+      :updatedAt,
+      :merchantFees,
+      :compliance,
+      :payoutMethod,
+      :estimatedDeliveryAt,
+      :recipient,
+      :withholdingAmount,
+      :withholdingCurrency,
+      :equivalentWithholdingAmount,
+      :equivalentWithholdingCurrency,
+      :methodDisplay,
+      :batch,
+      :coverFees,
+      :category,
+      :amount,
+      :currency,
+      :taxReportable,
+      :taxBasisAmount,
+      :taxBasisCurrency,
+      :tags,
+      :account,
+      :initiatedAt,
+      :settledAt,
+      :returnedAt,
+      :returnedNote,
+      :returnedReason,
+      :failureMessage,
+      :merchantId,
+      :checkNumber,
+      :forceUsTaxActivity
+    )
+  end
+end

data/lib/paymentrails/Recipient.rb

@@ -0,0 +1,44 @@
+module PaymentRails
+  class Recipient
+    attr_accessor(
+      :id,
+      :routeMinimum,
+      :routeType,
+      :estimatedFees,
+      :referenceId,
+      :email,
+      :name,
+      :lastName,
+      :firstName,
+      :type,
+      :taxType,
+      :status,
+      :language,
+      :complianceStatus,
+      :dob,
+      :contactEmails,
+      :passport,
+      :updatedAt,
+      :createdAt,
+      :gravatarUrl,
+      :governmentId,
+      :ssn,
+      :primaryCurrency,
+      :merchantId,
+      :payout,
+      :compliance,
+      :accounts,
+      :address,
+      :taxWithholdingPercentage,
+      :taxForm,
+      :taxFormStatus,
+      :inactiveReasons,
+      :payoutMethod,
+      :placeOfBirth,
+      :tags,
+      :taxDeliveryType,
+      :riskScore,
+      :isPortalUser
+    )
+  end
+end

data/lib/paymentrails/RecipientAccount.rb

@@ -0,0 +1,30 @@
+module PaymentRails
+  class RecipientAccount
+    attr_accessor(
+      :id,
+      :primary,
+      :currency,
+      :recipientAccountId,
+      :recipientId,
+      :recipientReferenceId,
+      :routeType,
+      :recipientFees,
+      :emailAddress,
+      :country,
+      :type,
+      :iban,
+      :accountNum,
+      :accountHolderName,
+      :swiftBic,
+      :branchId,
+      :bankId,
+      :bankName,
+      :bankAddress,
+      :bankCity,
+      :bankRegionCode,
+      :bankPostalCode,
+      :status,
+      :disabledAt
+    )
+  end
+end

data/lib/paymentrails/gateways/BalanceGateway.rb

@@ -0,0 +1,15 @@
+require_relative '../Client.rb'
+
+module PaymentRails
+  class BalanceGateway
+    def initialize(client)
+      @client = client
+    end
+
+    def find(term = '')
+      response = @client.get('/v1/balances/' + term )
+      JSON.parse(response,  object_class: OpenStruct)
+    end
+
+  end
+end

data/lib/paymentrails/gateways/BatchGateway.rb

@@ -0,0 +1,88 @@
+require_relative '../Client.rb'
+require_relative 'GatewayHelper'
+
+module PaymentRails
+  class BatchGateway
+    include GatewayHelper
+
+    def initialize(client)
+      @client = client
+    end
+
+    def find(batch_id)
+      response = @client.get('/v1/batches/' + batch_id)
+      batch_builder(response)
+    end
+
+    def all
+      response = @client.get('/v1/batches/')
+      batch_list_builder(response)
+    end
+
+    def create(body)
+      response = @client.post('/v1/batches/', body)
+      batch_builder(response)
+    end
+
+    def update(batch_id, body)
+      @client.patch('/v1/batches/' + batch_id, body)
+      true
+    end
+
+    def delete(batch_id)
+      @client.delete('/v1/batches/' + batch_id)
+      true
+    end
+
+    def generate_quote(batch_id)
+      response = @client.post('/v1/batches/' + batch_id + '/generate-quote', {})
+      batch_builder(response)
+    end
+
+    def start_processing(batch_id)
+      response = @client.post('/v1/batches/' + batch_id + '/start-processing', {})
+      batch_builder(response)
+    end
+
+    def search(page = 1, page_size = 10, term = '')
+      response = @client.get('/v1/batches?page=' + page.to_s + '&pageSize=' + page_size.to_s + '&search=' + term)
+      batch_list_builder(response)
+    end
+
+    def batch_builder(response)
+      batch = Batch.new
+      data = JSON.parse(response)
+      data.each do |key, value|
+        next unless key === 'batch'
+        loosely_hydrate_model(batch, value)
+      end
+      batch
+    end
+
+    def summary(batch_id)
+      response = @client.get('/v1/batches/' + batch_id + '/summary')
+      summary = BatchSummary.new
+      data = JSON.parse(response)
+      data.each do |key, value|
+        next unless key === 'batchSummary'
+        loosely_hydrate_model(summary, value)
+      end
+      summary
+    end
+
+    def batch_list_builder(response)
+      batches = []
+      data = JSON.parse(response)
+
+      data.each do |key, value|
+        next unless key === 'batches'
+        value.each do |newKey, _newValue|
+          batches.push(
+            loosely_hydrate_model(Batch.new, newKey)
+          )
+        end
+      end
+      batches
+    end
+  end
+end

data/lib/paymentrails/gateways/GatewayHelper.rb

@@ -0,0 +1,16 @@
+module PaymentRails
+  module GatewayHelper
+    def loosely_hydrate_model(klass_instance, attributes)
+      attributes.each do |k, v|
+        begin
+          klass_instance.send("#{k}=", v)
+        rescue NoMethodError
+          # TODO: The API is showing non-public attributes, once we remove them from the API response we can re-add this warning.
+          # warn "[PaymentRails] Unknown attribute #{k} for class #{klass_instance.class.name}"
+        end
+      end
+
+      klass_instance
+    end
+  end
+end

data/lib/paymentrails/gateways/InvoiceGateway.rb

@@ -0,0 +1,77 @@
+require_relative '../Client.rb'
+require_relative 'GatewayHelper'
+
+module PaymentRails
+  class InvoiceGateway
+    include GatewayHelper
+
+    def initialize(client)
+      @client = client
+    end
+
+    def find(body)
+      response = @client.post('/v1/invoices/get', body)
+      invoice_builder(response)
+    end
+
+    def create(body)
+      response = @client.post('/v1/invoices/create', body)
+      invoice_builder(response)
+    end
+
+    def create_line(body)
+      response = @client.post('/v1/invoices/create-lines', body)
+      invoice_builder(response)
+    end
+
+    def search(body)
+      response = @client.post('/v1/invoices/search', body)
+      invoice_list_builder(response)
+    end
+
+    def update(body)
+      @client.post('/v1/invoices/update', body)
+      true
+    end
+
+    def update_line(body)
+      @client.post('/v1/invoices/update-lines', body)
+      true
+    end
+
+    def delete(body)
+      @client.post('/v1/invoices/delete', body)
+      true
+    end
+
+    def delete_line(body)
+      @client.post('/v1/invoices/delete-lines', body)
+      true
+    end
+
+    def invoice_builder(response)
+      invoice = Invoice.new
+      data = JSON.parse(response)
+      data.each do |key, value|
+        next unless key === 'invoice'
+        loosely_hydrate_model(invoice, value)
+      end
+      invoice
+    end
+
+    def invoice_list_builder(response)
+      invoices = []
+      data = JSON.parse(response)
+
+      data.each do |key, value|
+        next unless key === 'invoices'
+        value.each do |newKey, _newValue|
+          invoices.push(
+            loosely_hydrate_model(Invoice.new, newKey)
+          )
+        end
+      end
+      invoices
+    end
+  end
+end