midas_client 0.2.1 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 949740b14437d4db4de04a152052379dc0c4a779
-  data.tar.gz: 27271aba5cbcef7c04ba2ae89252f2361a91c89b
+  metadata.gz: 81c854614d06fb0820ef6fde44ea13ee781266c7
+  data.tar.gz: 1d40a8f4350905e685f539f619380fdfac92b7e3
 SHA512:
-  metadata.gz: 90935d84f635edefd4e8e65e6df770c7be8ee73d1fe4d457fb5881ad32afd11a6247132d49f920f53c455a53911f33fe6dc880da863b3e169dcb64ac58c41080
-  data.tar.gz: edfe960092329e9cb0ee4dc761ac57c31000c7a718560b9eddbebcfc2964a397b9d0d4a9a78a327350afc7729d98b02bc097a6491ab3c57ecca539f8abc42dfe
+  metadata.gz: e9ee9daec5887385a65edccca415957bcef666226a1f6531adc80a42798f8da574b9da52b3d78da2147faad71287bb5a9dd5e1f2dfa8ae7a0fa035250a9a951e
+  data.tar.gz: 61ffb8f7cda498954e0e169098ba0de225034c3d7446292da61bebb2e8e20d0e1209e961eea2795339447108956fd7fac4a45ca33eefd325573381a54033dad5

data/README.md

@@ -33,8 +33,10 @@ Use client as follow:
 
 Request
 
-    $ transaction = MidasClient::Transaction.new('pdv01','/eFRsg8RLne+I0GlECQofYvnsDfb0w==')
-    $ transaction.card_store({"externalId":"teste_midas_client_00002", "pan":"5529525900844124", "expirationMonth":"01", "expirationYear":"2021", "holderName":"TESTE MIDAS CLIENT", "customer":{ "documentType":"CPF", "documentNumber":"36549450152"}})
+    $ request = MidasClient::Request.new('testes-01','/eFRsg8RLne+I0GlECQofYvnsDfb0w==', 'DEVELOPMENT')
+    $ request.transaction.card_store({"externalId":"teste_midas_client_00002", "pan":"5529525900844124", "expirationMonth":"01", "expirationYear":"2021", "holderName":"TESTE MIDAS CLIENT", "customer":{ "documentType":"CPF", "documentNumber":"36549450152"}})
+    $ request.subscription.cancel_subscription("subscription_token_00002")
+    $ request.query.list_customers
 
 Response
 
@@ -42,7 +44,29 @@ Response
     $ [17/05/2017 20:48:06.103][RESPONSE] {:result=>{:success=>true, :code=>"010", :message=>"O cartao jah foi armazenado anteriormente"}, :brand=>"MASTER", :cardToken=>"f887d732863eb3ef2e45c0bd8b57ed33"} 
 
 ## Change Releases
-VERSION - 0.2.0 - 2017/10/11
+VERSION - 0.2.4 - 2017/11/01
+
+- Refactoring QUERIES CONSTANT to QUERY
+- Query to list creditcards from a Point of Sale (MidasClient::Query.list_creditcards)
+- Query to list creditcards from user's document number (MidasClient::Transation.query_user_cards)
+- Query to list transactions by an array of external ids (MidasClient::Query.by_external_ids)
+- Query to list transactions by an array of transaction tokens (MidasClient::Query.by_transaction_tokens)
+- Query to list customers from  de POint of Sale (MidasClient::Query.list_customers)
+- Access attributes at Request to acess all subclasses from Request as singleton methods
+- Refactoring class Queries name to Query
+- read.me
+
+VERSION - 0.2.3 - 2017/10/25
+
+- Bug fix at MidasClient::Subscription.subscription_update
+- read.me
+
+VERSION - 0.2.2 - 2017/10/16
+
+- Query to return all subscritions for a Point Of Sale at module Query.
+- read.me
+
+VERSION - 0.2.1 - 2017/10/11
 
 - Changing Development API endpoint
 - read.me

data/lib/midas_client/endpoints.rb

@@ -43,7 +43,8 @@ module MidasClient
         cancel: '/transaction/creditcard/{transactionToken}/cancel',
         refund: '/transaction/creditcard/{transactionToken}/refund',
         query_by_transaction: '/transaction/{transactionToken}',
-        callback: 'http://matricula.crossfitlendarios.com.br/callback'
+        callback: 'http://matricula.crossfitlendarios.com.br/callback',
+        cards_by_user: '/customer/{documentType}/{documentNumber}/creditcard',
     }
 
     SUBSCRIPTIONS = {
@@ -62,7 +63,12 @@ module MidasClient
     QUERIES = {
         context: '/midas-query/v2',
         by_external_id: '/transactions/external-id/{externalId}',
+        by_external_ids: '/transactions/external-ids',
+        by_transaction_tokens: '/transactions/transaction-tokens',
         by_period: '/transactions?startDate={startDate}&endDate={endDate}&status={status}',
+        subscriptions: "/subscriptions?status={status}",
+        creditcards: '/creditcards',
+        customers: '/customers'
     }
 
     MANAGEMENTS = {

data/lib/midas_client/query.rb

@@ -1,21 +1,21 @@
 module MidasClient
-    class Queries < Request
-
-      #= This method performs a query by a range date.
-      # This is a is synchronous operation, using method GET
-      #
-      # Params:
-      #   start_date: date format YYYY-MM-DD
-      #   send_date: date format YYYY-MM-DD
-      #
-      #
-      # Response:
-      #   result: {
-      #     success: true/false
-      #     code: "XXX"
-      #     message: "Some message to you"
-      #   }
-      def transaction_by_date(start_date=(Date.today - 7).strftime('%Y-%m-%d'), end_date = Date.today.strftime('%Y-%m-%d'), status = nil)
+    class Query < Request
+
+    #= This method performs a query by a range date.
+    # This is a is synchronous operation, using method GET
+    #
+    # Params:
+    #   start_date: date format YYYY-MM-DD
+    #   send_date: date format YYYY-MM-DD
+    #
+    #
+    # Response:
+    #   result: {
+    #     success: true/false
+    #     code: "XXX"
+    #     message: "Some message to you"
+    #   }
+    def transaction_by_date(start_date=(Date.today - 7).strftime('%Y-%m-%d'), end_date = Date.today.strftime('%Y-%m-%d'), status = nil)
         log "Entrei em transaction_by_date"
         # define o método de envio da requisição
         method = :get
@@ -44,8 +44,6 @@ module MidasClient
         response[:transactions] = transactions
 
         response
-      end
-
     end
 
     #= This method performs a query by a specific transaction's identifier, called external ID.
@@ -61,7 +59,9 @@ module MidasClient
     #     code: "XXX"
     #     message: "Some message to you"
     #   }
-    def query_external_id(externalId)
+    def by_external_id(externalId)
+      log "Entrei em by_external_id"
+
       # define o método de envio da requisição
       method = :get
 
@@ -70,4 +70,174 @@ module MidasClient
 
       request(method, endpoint, login, password, {})
     end
+
+    #= This method performs a query by an array of transaction's identifier.
+    # This is a is synchronous operation, using method GET
+    #
+    # Params:
+    #   none
+    #
+    #
+    # Response:
+    #   result: {
+    #     success: true/false
+    #     code: "XXX"
+    #     message: "Some message to you"
+    #   }
+    def by_external_ids(externalIds = [])
+      log "Entrei em by_external_ids"
+
+      # define o método de envio da requisição
+      method = :post
+
+      # monta a URL de chamada da requisição
+      endpoint =  get_env[:url] + EndPoints::QUERIES[:context] + EndPoints::QUERIES[:by_external_ids]
+
+      request(method, endpoint, login, password, {externalIds: externalIds})
+    end
+
+    #= This method performs a query by an array of transaction's token.
+    # This is a is synchronous operation, using method GET
+    #
+    # Params:
+    #   none
+    #
+    #
+    # Response:
+    #   result: {
+    #     success: true/false
+    #     code: "XXX"
+    #     message: "Some message to you"
+    #   }
+    def by_transaction_tokens(transactionTokens = [])
+      log "Entrei em by_external_ids"
+
+      # define o método de envio da requisição
+      method = :post
+
+      # monta a URL de chamada da requisição
+      endpoint =  get_env[:url] + EndPoints::QUERIES[:context] + EndPoints::QUERIES[:by_transaction_tokens]
+
+      request(method, endpoint, login, password, {transactionTokens: transactionTokens})
+    end
+
+    #= This method performs a query to return all subscriptions for a Point Of Sale by status
+    # This is a is synchronous operation, using method GET
+    #
+    # Params:
+    #   status: ACTIVE/CANCELLED
+    #
+    # Response:
+    #   result: {
+    #     success: true/false
+    #     code: "XXX"
+    #     message: "Some message to you"
+    #   }
+    def subscriptions(status = nil)
+      log "Entrei em subscriptions"
+      # define o método de envio da requisição
+      method = :get
+
+      # monta a URL de chamada da requisição
+      endpoint =  get_env[:url] + EndPoints::QUERIES[:context] + EndPoints::QUERIES[:subscriptions]
+
+      # monta os parâmetros da requisição na url
+      endpoint = status.blank? ? endpoint.gsub("status={status}", '') : endpoint.gsub("{status}", status)
+
+      # faz a chamada a plataforma de pagamento (MIDAS)
+      response = request(method, endpoint, self.login, self.password, {})
+
+      result = response[:result]
+      pagging = response[:pagging]
+      if response[:subscriptions].kind_of?(Array) || response[:subscriptions].blank?
+        subscriptions = response[:subscriptions]
+      else
+        subscription_array = []
+        subscription_array << response[:subscriptions]
+        subscriptions = subscription_array
+      end
+
+      response[:result] = result
+      response[:pagging] = pagging
+      response[:subscriptions] = subscriptions
+
+      response
+    end
+
+    #= This method performs a query to return all creditcards stored for a Point Of Sale
+    # This is a is synchronous operation, using method GET
+    #
+    # Params:
+    #   none
+    #
+    # Response:
+    #   result: {
+    #     success: true/false
+    #     code: "XXX"
+    #     message: "Some message to you"
+    #   }
+    #   creditCards: [
+    #   {
+    #      brand: "MASTER",
+    #      panLastDigits": "4832",
+    #      expirationMonth": 10,
+    #      expirationYear": 2019,
+    #      holderName": "Nome Portador",
+    #      customer: {
+    #         documentType: "CPF",
+    #         documentNumber: "12345678900"
+    #      },
+    #      token: "b7553c62bc93ed0708b4behfcf28f3592"
+    #    }
+    def list_creditcards()
+      log "Entrei em list_creditcards"
+      # define o método de envio da requisição
+      method = :get
+
+      # monta a URL de chamada da requisição
+      endpoint =  get_env[:url] + EndPoints::QUERIES[:context] + EndPoints::QUERIES[:creditcards]
+
+      # faz a chamada a plataforma de pagamento (MIDAS)
+      request(method, endpoint, self.login, self.password, {})
+    end
+
+    #= This method performs a query to return all creditcards stored for a Point Of Sale
+    # This is a is synchronous operation, using method GET
+    #
+    # Params:
+    #   none
+    #
+    # Response:
+    #   result: {
+    #     success: true/false
+    #     code: "XXX"
+    #     message: "Some message to you"
+    #   }
+    #   creditCards: [
+    #   {
+    #      brand: "MASTER",
+    #      panLastDigits": "4832",
+    #      expirationMonth": 10,
+    #      expirationYear": 2019,
+    #      holderName": "Nome Portador",
+    #      customer: {
+    #         documentType: "CPF",
+    #         documentNumber: "12345678900"
+    #      },
+    #      token: "b7553c62bc93ed0708b4behfcf28f3592"
+    #    }
+    def list_customers()
+      log "Entrei em list_customers"
+      # define o método de envio da requisição
+      method = :get
+
+      # monta a URL de chamada da requisição
+      endpoint =  get_env[:url] + EndPoints::QUERIES[:context] + EndPoints::QUERIES[:customers]
+
+      # faz a chamada a plataforma de pagamento (MIDAS)
+      request(method, endpoint, self.login, self.password, {})
+    end
+
+
+  end
 end

data/lib/midas_client/request.rb

@@ -5,6 +5,9 @@ module MidasClient
     include EndPoints
 
     attr_accessor :login, :password, :environment
+    attr_accessor :transaction
+    attr_accessor :subscription
+    attr_accessor :query
 
     def initialize(login=nil, password=nil, environment='DEVELOPMENT', option={})
       @login = login
@@ -87,5 +90,17 @@ module MidasClient
       response
     end
 
+    def transaction
+      @transaction  ||= Transaction.new(login, password, environment)
+    end
+
+    def subscription
+      @subscription ||= Subscription.new(login, password, environment)
+    end
+
+    def query
+      @query ||= Query.new(login, password, environment)
+    end
+
   end
 end

data/lib/midas_client/subscription.rb

@@ -81,7 +81,7 @@ module MidasClient
     #
     # Response:
     #   result: {
-    #     success: true/false
+    #     success: true/falseb0FIYhr/xCvGFMuR1Wg059X/0cqwLg==
     #     code: "XXX"
     #     message: "Some message to you"
     #   }
@@ -102,9 +102,11 @@ module MidasClient
     # Params:
     #   subscriptionToken: querystring (Subscription unique identification generated by our
     #                             gateway and received in the subscription's creation response)
-    #   amount: number (Only integer numbers, with the last two digits representing the cents.
+    #   params: {
+    #             amount: number (Only integer numbers, with the last two digits representing the cents.
     #                   For example: 100 is equivalent to R$ 1,00)
-    #   callbackUrl string - URL to receive the result for each invoice charge
+    #             callbackUrl: string - URL to receive the result for each invoice charge
+    #           }
     #
     # Response:
     #   result: {
@@ -123,10 +125,12 @@ module MidasClient
       response = request(method, endpoint, self.login, self.password, params)
 
       # recupera a lista de invoices da assinatura para chamar o método de atualização de cada invoice.
-      result, invoices = subscription_invoices(subscription_token)
+      response_invoices = subscription_invoices(subscription_token)
+      result = response_invoices[:result]
+      invoices = response_invoices[:invoices]
 
       # filtra apenas as invoices em aberto
-      opened_invoices = invoices.select{|s| s[:status] == 'OPEN'}
+      opened_invoices = invoices.select{|s| s[:status] == 'OPEN'} unless invoices.blank?
 
       # percorre cada uma das invoices abertas e chama o método de atualização
       opened_invoices.each do |inv|

data/lib/midas_client/transaction.rb

@@ -377,5 +377,28 @@ module MidasClient
         request(method, endpoint, login, password, {})
       end
 
+      #= This method performs a query to list all creditcards form a user.
+      # This is a is synchronous operation, using method GET
+      #
+      # Params:
+      #   documentType: string (CPF or CNPJ)
+      #   documentNumber: string
+      #
+      #
+      # Response:
+      #   result: {
+      #     success: true/false
+      #     code: "XXX"
+      #     message: "Some message to you"
+      #   }
+      def query_user_cards(document_type='CPF', document_number)
+        # define o método de envio da requisição
+        method = :get
+
+        # monta a URL de chamada da requisição
+        endpoint =  get_env[:url] + EndPoints::OPERATIONS[:context] + EndPoints::OPERATIONS[:cards_by_user].gsub('{documentType}', document_type).gsub('{documentNumber}', document_number)
+
+        request(method, endpoint, login, password, {})
+      end
     end
 end

data/lib/midas_client/version.rb

@@ -1,3 +1,3 @@
 module MidasClient
-  VERSION = "0.2.1"
+  VERSION = "0.2.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: midas_client
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.4
 platform: ruby
 authors:
 - Carlos Andre Oliveira
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-10-11 00:00:00.000000000 Z
+date: 2017-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler