paymentrails-zero 0.2.13

data/lib/paymentrails/gateways/InvoicePaymentGateway.rb

@@ -0,0 +1,56 @@
+require_relative '../Client.rb'
+require_relative 'GatewayHelper'
+
+module PaymentRails
+  class InvoicePaymentGateway
+    include GatewayHelper
+
+    def initialize(client)
+      @client = client
+    end
+
+    def create(body)
+      response = @client.post('/v1/invoices/payment/create', body)
+      invoice_payment_builder(response)
+    end
+
+    def update(body)
+      @client.post('/v1/invoices/payment/update', body)
+      true
+    end
+
+    def delete(body)
+      @client.post('/v1/invoices/payment/delete', body)
+      true
+    end
+
+    def search(body)
+      response = @client.post('/v1/invoices/payment/search', body)
+      invoice_payments_list_builder(response)
+    end
+
+    def invoice_payment_builder(response)
+      invoice_payment = InvoicePayment.new
+      data = JSON.parse(response)
+      data.each do |key, value|
+        next unless key === 'invoicePayment'
+        loosely_hydrate_model(invoice_payment, value)
+      end
+      invoice_payment
+    end
+
+    def invoice_payments_list_builder(response)
+      invoice_payments = []
+      data = JSON.parse(response)
+
+      data.each do |key, value|
+        next unless key === 'invoicePayments'
+        value.each do |newKey, _newValue|
+          invoice_payment = loosely_hydrate_model(InvoicePayment.new, newKey)
+          invoice_payments.push(invoice_payment)
+        end
+      end
+      invoice_payments
+    end
+  end
+end

data/lib/paymentrails/gateways/OfflinePaymentGateway.rb

@@ -0,0 +1,61 @@
+require_relative '../Client.rb'
+require_relative 'GatewayHelper'
+
+module PaymentRails
+  class OfflinePaymentGateway
+    include GatewayHelper
+
+    def initialize(client)
+      @client = client
+    end
+
+    def create(recipient_id, body)
+      response = @client.post('/v1/recipients/' + recipient_id + '/offlinePayments', body)
+      offline_payment_builder(response)
+    end
+
+    def update(recipient_id, offline_payment_id, body)
+      @client.patch('/v1/recipients/' + recipient_id + '/offlinePayments/' + offline_payment_id, body)
+      true
+    end
+
+    def delete(recipient_id, offline_payment_id)
+      @client.delete('/v1/recipients/' + recipient_id + '/offlinePayments/' + offline_payment_id)
+      true
+    end
+
+    def search(recipient_id = '', page = 1, page_size = 10, term = '')
+      if recipient_id === ''
+        response = @client.get('/v1/offline-payments?page=' + page.to_s + '&pageSize=' + page_size.to_s + '&search=' + term)
+      else
+        response = @client.get('/v1/recipients/' + recipient_id + '/offlinePayments?page=' + page.to_s + '&pageSize=' + page_size.to_s + '&search=' + term)
+      end
+
+      offline_payments_list_builder(response)
+    end
+
+    def offline_payment_builder(response)
+      offline_payment = OfflinePayment.new
+      data = JSON.parse(response)
+      data.each do |key, value|
+        next unless key === 'offlinePayment'
+        loosely_hydrate_model(offline_payment, value)
+      end
+      offline_payment
+    end
+
+    def offline_payments_list_builder(response)
+      offline_payments = []
+      data = JSON.parse(response)
+
+      data.each do |key, value|
+        next unless key === 'offlinePayments'
+        value.each do |newKey, _newValue|
+          offline_payment = loosely_hydrate_model(OfflinePayment.new, newKey)
+          offline_payments.push(offline_payment)
+        end
+      end
+      offline_payments
+    end
+  end
+end

data/lib/paymentrails/gateways/PaymentGateway.rb

@@ -0,0 +1,61 @@
+require_relative '../Client.rb'
+require_relative 'GatewayHelper'
+
+module PaymentRails
+  class PaymentGateway
+    include GatewayHelper
+
+    def initialize(client)
+      @client = client
+    end
+
+    def find(batch_id, payment_id)
+      response = @client.get('/v1/batches/' + batch_id + '/payments/' + payment_id)
+      payment_builder(response)
+    end
+
+    def create(batch_id, body)
+      response = @client.post('/v1/batches/' + batch_id + '/payments', body)
+      payment_builder(response)
+    end
+
+    def update(batch_id, payment_id, body)
+      @client.patch('/v1/batches/' + batch_id + '/payments/' + payment_id, body)
+      true
+    end
+
+    def delete(batch_id, payment_id)
+      @client.delete('/v1/batches/' + batch_id + '/payments/' + payment_id)
+      true
+    end
+
+    def search(batch_id, page = 1, page_size = 10, term = '')
+      response = @client.get('/v1/batches/' + batch_id.to_s + '/payments?page=' + page.to_s + '&pageSize=' + page_size.to_s + '&search=' + term)
+      payments_list_builder(response)
+    end
+
+    def payment_builder(response)
+      payment = Payment.new
+      data = JSON.parse(response)
+      data.each do |key, value|
+        next unless key === 'payment'
+        loosely_hydrate_model(payment, value)
+      end
+      payment
+    end
+
+    def payments_list_builder(response)
+      payments = []
+      data = JSON.parse(response)
+
+      data.each do |key, value|
+        next unless key === 'payments'
+        value.each do |newKey, _newValue|
+          payment = loosely_hydrate_model(Payment.new, newKey)
+          payments.push(payment)
+        end
+      end
+      payments
+    end
+  end
+end

data/lib/paymentrails/gateways/RecipientAccountGateway.rb

@@ -0,0 +1,61 @@
+require_relative '../Client.rb'
+require_relative 'GatewayHelper'
+
+module PaymentRails
+  class RecipientAccountGateway
+    include GatewayHelper
+
+    def initialize(client)
+      @client = client
+    end
+
+    def find(recipient_id, recipient_account_id)
+      response = @client.get('/v1/recipients/' + recipient_id + '/accounts/' + recipient_account_id)
+      recipient_account_builder(response)
+    end
+
+    def all(recipient_id)
+      response = @client.get('/v1/recipients/' + recipient_id + '/accounts/')
+      recipient_account_list_builder(response)
+    end
+
+    def create(recipient_id, body)
+      response = @client.post('/v1/recipients/' + recipient_id + '/accounts', body)
+      recipient_account_builder(response)
+    end
+
+    def update(recipient_id, recipient_account_id, body)
+      response = @client.patch('/v1/recipients/' + recipient_id + '/accounts/' + recipient_account_id, body)
+      recipient_account_builder(response)
+    end
+
+    def delete(recipient_id, recipient_account_id)
+      @client.delete('/v1/recipients/' + recipient_id + '/accounts/' + recipient_account_id)
+      true
+    end
+
+    def recipient_account_builder(response)
+      recipient_account = RecipientAccount.new
+      data = JSON.parse(response)
+      data.each do |key, value|
+        next unless key === 'account'
+        loosely_hydrate_model(recipient_account, value)
+      end
+      recipient_account
+    end
+
+    def recipient_account_list_builder(response)
+      recipient_accounts = []
+      data = JSON.parse(response)
+
+      data.each do |key, value|
+        next unless key === 'accounts'
+        value.each do |newKey, _newValue|
+          recipient_account = loosely_hydrate_model(RecipientAccount.new, newKey)
+          recipient_accounts.push(recipient_account)
+        end
+      end
+      recipient_accounts
+    end
+  end
+end

data/lib/paymentrails/gateways/RecipientGateway.rb

@@ -0,0 +1,68 @@
+require_relative '../Client.rb'
+require_relative 'GatewayHelper'
+
+module PaymentRails
+  class RecipientGateway
+    include GatewayHelper
+
+    def initialize(client)
+      @client = client
+    end
+
+    def find(recipient_id)
+      response = @client.get('/v1/recipients/' + recipient_id)
+      recipient_builder(response)
+    end
+
+    def create(body)
+      response = @client.post('/v1/recipients/', body)
+      recipient_builder(response)
+    end
+
+    def update(recipient_id, body)
+      @client.patch('/v1/recipients/' + recipient_id, body)
+      true
+    end
+
+    def delete(recipient_id)
+      @client.delete('/v1/recipients/' + recipient_id)
+      true
+    end
+
+    # TODO: if we can afford a breaking change ideally these should be kwargs
+    def search(page = 1, page_size = 10, prefix_search = '', filters = {})
+      query_string = URI.encode_www_form(
+        page: page.to_s,
+        pageSize: page_size.to_s,
+        search: prefix_search,
+        **filters
+      )
+      response = @client.get("/v1/recipients?#{query_string}")
+      recipient_list_builder(response)
+    end
+
+    def recipient_builder(response)
+      recipient = Recipient.new
+      data = JSON.parse(response)
+      data.each do |key, value|
+        next unless key === 'recipient'
+        loosely_hydrate_model(recipient, value)
+      end
+      recipient
+    end
+
+    def recipient_list_builder(response)
+      recipients = []
+      data = JSON.parse(response)
+
+      data.each do |key, value|
+        next unless key === 'recipients'
+        value.each do |newKey, _newValue|
+          recipient = loosely_hydrate_model(Recipient.new, newKey)
+          recipients.push(recipient)
+        end
+      end
+      recipients
+    end
+  end
+end

data/lib/paymentrails.rb

@@ -0,0 +1,28 @@
+require 'paymentrails/Configuration'
+require 'paymentrails/Gateway'
+
+require 'paymentrails/gateways/BalanceGateway'
+require 'paymentrails/gateways/BatchGateway'
+require 'paymentrails/gateways/PaymentGateway'
+require 'paymentrails/gateways/RecipientGateway'
+require 'paymentrails/gateways/RecipientAccountGateway'
+require 'paymentrails/gateways/OfflinePaymentGateway'
+require 'paymentrails/gateways/InvoiceGateway'
+require 'paymentrails/gateways/InvoicePaymentGateway'
+
+require 'paymentrails/Balance'
+require 'paymentrails/Batch'
+require 'paymentrails/BatchSummary'
+require 'paymentrails/Exceptions'
+require 'paymentrails/Payment'
+require 'paymentrails/Recipient'
+require 'paymentrails/RecipientAccount'
+require 'paymentrails/OfflinePayment'
+require 'paymentrails/Invoice'
+require 'paymentrails/InvoicePayment'
+
+module PaymentRails
+  def self.client(key, secret, environment = 'production', **optionals)
+    Gateway.new(Configuration.new(key, secret, environment, **optionals))
+  end
+end

data/paymentrails.gemspec

@@ -0,0 +1,18 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name = "paymentrails-zero"
+  s.summary = "Trolley Ruby SDK"
+  s.description = "Ruby SDK for interacting with the Trolley API"
+  s.version = '0.2.13'
+  s.homepage = 'https://trolley.com/'
+  s.email = ['developer-tools@trolley.com']
+  s.license = "MIT"
+  s.author = "PaymentRails"
+  s.files = Dir.glob ["README.rdoc", "LICENSE", "lib/**/*.{rb,crt}", "spec/**/*", "*.gemspec"]
+  s.required_ruby_version = '>= 2.4'
+  s.add_development_dependency 'dotenv', '~> 2'
+  s.add_development_dependency 'rake', '~> 12'
+  s.add_development_dependency "rubocop", '~> 0.77.0'
+  s.add_development_dependency 'test-unit', '~> 3'
+end

data/spec/integration/BatchTest.rb

@@ -0,0 +1,121 @@
+require_relative 'helper'
+
+class BatchTest < Test::Unit::TestCase
+  def setup
+    @client = PaymentRails.client(
+      ENV.fetch('SANDBOX_API_KEY'),
+      ENV.fetch('SANDBOX_SECRET_KEY'),
+      'production',
+      proxy_uri: ENV['PROXY_URI']
+    )
+  end
+
+  def create_recipient
+    uuid = SecureRandom.uuid.to_s
+    recipient = @client.recipient.create(
+      type: 'individual',
+      firstName: 'Tom',
+      lastName: 'Jones',
+      email: 'test.batch' + uuid + '@example.com',
+      address: {
+        street1: '123 Wolfstrasse',
+        city: 'Berlin',
+        country: 'DE',
+        postalCode: '123123'
+      }
+    )
+    @client.recipient_account.create(recipient.id, type: 'bank-transfer', currency: 'EUR', country: 'DE', iban: 'DE89 3704 0044 0532 0130 00')
+    recipient
+  end
+
+  def test_create
+    batch = @client.batch.create(sourceCurrency: 'USD', description: 'Integration Test Create')
+    assert_not_nil(batch)
+    assert_not_nil(batch.id)
+
+    batch = @client.batch.all
+    assert_true(batch.count > 0)
+  end
+
+  def test_update
+    batch = @client.batch.create(sourceCurrency: 'USD', description: 'Integration Test Create')
+    assert_not_nil(batch)
+    assert_not_nil(batch.id)
+
+    all = @client.batch.all
+    assert_true(all.count > 0)
+
+    response = @client.batch.update(batch.id, description: 'Integration Update')
+    assert_true(response)
+    findBatch = @client.batch.find(batch.id)
+    assert_equal('Integration Update', findBatch.description)
+    assert_equal('open', batch.status)
+
+    response = @client.batch.delete(batch.id)
+    assert_true(response)
+  end
+
+  def test_create_with_payments
+    recipientAlpha = create_recipient
+    recipientBeta = create_recipient
+
+    batch = @client.batch.create(
+      sourceCurrency: 'USD', description: 'Integration Test Payments', payments: [
+        { targetAmount: '10.00', targetCurrency: 'EUR', recipient: { id: recipientAlpha.id } },
+        { sourceAmount: '10.00', recipient: { id: recipientBeta.id } }
+      ]
+    )
+
+    assert_not_nil(batch)
+    assert_not_nil(batch.id)
+
+    findBatch = @client.batch.find(batch.id)
+    assert_not_nil(findBatch)
+    assert_equal(2, findBatch.totalPayments)
+
+    payments = @client.payment.search(batch.id)
+    payments.each { |item| assert_equal('pending', item.status) }
+  end
+
+  def test_payments
+    batch = @client.batch.create(sourceCurrency: 'USD', description: 'Integration Test Payments')
+    assert_not_nil(batch)
+    assert_not_nil(batch.id)
+
+    recipient = create_recipient
+
+    payment = @client.payment.create(batch.id, sourceAmount: '10.00', recipient: { id: recipient.id })
+
+    assert_not_nil(payment)
+    assert_not_nil(payment.id)
+
+    response = @client.payment.update(batch.id, payment.id, sourceAmount: '20.00')
+    assert_true(response)
+
+    response = @client.payment.delete(batch.id, payment.id)
+    assert_true(response)
+  end
+
+  def test_processing
+    recipientAlpha = create_recipient
+    recipientBeta = create_recipient
+
+    batch = @client.batch.create(
+      sourceCurrency: 'USD', description: 'Integration Test Payments', payments: [
+        { targetAmount: '10.00', targetCurrency: 'EUR', recipient: { id: recipientAlpha.id } },
+        { sourceAmount: '10.00', recipient: { id: recipientBeta.id } }
+      ]
+    )
+    assert_not_nil(batch)
+    assert_not_nil(batch.id)
+
+    summary = @client.batch.summary(batch.id)
+    assert_equal(2, summary.detail['bank-transfer']['count'])
+
+    quote = @client.batch.generate_quote(batch.id)
+    assert_not_nil(quote)
+
+    start = @client.batch.start_processing(batch.id)
+    assert_not_nil(start)
+  end
+end

data/spec/integration/InvoicePaymentTest.rb

@@ -0,0 +1,99 @@
+require_relative 'helper'
+
+class InvoicePaymentTest < Test::Unit::TestCase
+  def setup
+    @client = PaymentRails.client(
+      ENV.fetch('SANDBOX_API_KEY'),
+      ENV.fetch('SANDBOX_SECRET_KEY'),
+      'production',
+      proxy_uri: ENV['PROXY_URI']
+    )
+  end
+
+  def create_recipient
+    uuid = SecureRandom.uuid.to_s
+    recipient = @client.recipient.create(
+      type: 'individual',
+      firstName: 'Tom',
+      lastName: 'Jones',
+      email: 'test.batch' + uuid + '@example.com',
+      address: {
+        street1: '123 Wolfstrasse',
+        city: 'Berlin',
+        country: 'DE',
+        postalCode: '123123'
+      }
+    )
+    @client.recipient_account.create(recipient.id, type: 'bank-transfer', currency: 'EUR', country: 'DE', iban: 'DE89 3704 0044 0532 0130 00')
+    recipient
+  end
+
+  def test_create
+    recipient = create_recipient
+    invoice = @client.invoice.create(recipientId: recipient.id, description: 'Integration Test Invoice Create')
+    assert_not_nil(invoice)
+    assert_not_nil(invoice.id)
+    assert_equal('open', invoice.status)
+
+    invoice_line = @client.invoice.create_line(invoiceId: invoice.id, lines: [{ unitAmount: { value: '2000', currency: 'USD' } }])
+    assert_not_nil(invoice_line.lines)
+    assert_not_nil(invoice_line.lines.first['id'])
+
+    @client.invoice_payment.create(ids: [invoiceId: invoice.id])
+    invoice_payments = @client.invoice_payment.search(invoiceIds: [invoice.id])
+    assert_true(invoice_payments.count > 0)
+
+    findInvoice = @client.invoice.find(invoiceId: invoice.id)
+    assert_equal('paid', findInvoice.status)
+  end
+
+  def test_update
+    recipient = create_recipient
+
+    invoice = @client.invoice.create(recipientId: recipient.id, description: 'Integration Test Invoice Create')
+    assert_not_nil(invoice)
+    assert_not_nil(invoice.id)
+
+    invoices = @client.invoice.search({})
+    assert_true(invoices.count > 0)
+
+    invoice_line = @client.invoice.create_line(invoiceId: invoice.id, lines: [{ unitAmount: { value: '2000', currency: 'USD' } }])
+    assert_not_nil(invoice_line.lines)
+    assert_not_nil(invoice_line.lines.first['id'])
+
+    invoice_payment = @client.invoice_payment.create(ids: [invoiceId: invoice.id])
+    invoice_payments = @client.invoice_payment.search(invoiceIds: [invoice.id])
+    assert_true(invoice_payments.count > 0)
+    assert_equal('2000.00', invoice_payments.first.amount['value'])
+
+    response = @client.invoice_payment.update(paymentId: invoice_payment.paymentId, invoiceLineId: invoice_payment.invoicePayments.first['invoiceLineId'], amount: { value: '5000', currency: 'USD' })
+    assert_true(response)
+    invoice_payments = @client.invoice_payment.search(invoiceIds: [invoice.id])
+    assert_true(invoice_payments.count > 0)
+    assert_equal('5000.00', invoice_payments.first.amount['value'])
+  end
+
+  def test_delete
+    recipient = create_recipient
+
+    invoice = @client.invoice.create(recipientId: recipient.id, description: 'Integration Test Invoice Create')
+    assert_not_nil(invoice)
+    assert_not_nil(invoice.id)
+
+    invoices = @client.invoice.search({})
+    assert_true(invoices.count > 0)
+
+    invoice_line = @client.invoice.create_line(invoiceId: invoice.id, lines: [{ unitAmount: { value: '2000', currency: 'USD' } }])
+    assert_not_nil(invoice_line.lines)
+    assert_not_nil(invoice_line.lines.first['id'])
+
+    invoice_payment = @client.invoice_payment.create(ids: [invoiceId: invoice.id])
+    invoice_payments = @client.invoice_payment.search(invoiceIds: [invoice.id])
+    assert_true(invoice_payments.count > 0)
+
+    response = @client.invoice_payment.delete(paymentId: invoice_payment.paymentId, invoiceLineIds: [invoice_payment.invoicePayments.first['invoiceLineId']])
+    assert_true(response)
+    invoice_payments = @client.invoice_payment.search(invoiceIds: [invoice.id])
+    assert_true(invoice_payments.count == 0)
+  end
+end