mp_api 0.3.4 → 0.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b92b7754e51f42f0fe88876439a45b7bd486f3d4a0b4ddbe7b0bc7f9f26f75e9
-  data.tar.gz: 34b9b85fe2f993b63baa83f4cc6a2ef4b3a579ac3c9449fabd6ec91c703d6e85
+  metadata.gz: af6c473fbc12cab2fcc872a734480743f6da9e938f0289f58bcdf4b07275a9dd
+  data.tar.gz: 8c37b5e63d81b7187358db698480c57fcd5e8089c5ae06ec8407e9074420aaae
 SHA512:
-  metadata.gz: bd4bb291826bb0883ad111cc1134636b5235c8022f0a03da6622ff441927f47ffc3a5836c119bf75c0ae18ec8d7dadf3fd3898a466036b66c5a7f93bbef52a12
-  data.tar.gz: 688c348fa83bf6d42289673a8c114e5406534548991e7e0d338feb7d79280311352ca131041c36864a8be36ff49b5c67fd43af9a8d956dcd0aa3d609e8699e3c
+  metadata.gz: 2f2a9a0bdabd4326ddf2167258bf8584d5efa6c7ddc03bd5c6cf85fd9fe7a6353fc29935ce4268033acae052fcb3e03852e1b12289a86b9b31f7022d352605b1
+  data.tar.gz: 85ae787be3b4461d11bfc97f88def20b582e3d04d934e2fc785b862a7f26c28ea269aac143177a216c1ae8809b4e1a87ce4005a089d57450444115d79fb6caae

data/lib/generators/mp_api/install/templates/initializer.rb

@@ -1,3 +1,3 @@
 MpApi.configure do |config|
   # config.access_token = nil
-end
+end

data/lib/mp_api/client.rb

@@ -1,42 +1,45 @@
-module MpApi
-  class Client < Ac::Base
-    BASE_URL = "https://api.mercadopago.com/v1/"
-    MAX_RETRIES = 1
-    attr_reader :access_token
-    def initialize(access_token=MpApi.configuration.access_token)
-      @headers = {
-        "Content-Type": "application/json",
-        'x-idempotency-key' => SecureRandom.uuid
-      }
-      super access_token
-    end
-
-    def create_payment(body)
-      post("/payments", body: body, headers: @headers) { |response| validate_response(response, 'id')}
-    end
-
-    def get_payment(payment_id)
-      get("/payments/#{payment_id}") { |response| validate_response(response, 'id')}
-    end
-
-    def create_token(card_token_data)
-      post("/card_tokens", body: card_token_data, headers: @headers) { |response| validate_response(response, 'id')}
-    end
-    
-    def search_payment_methods(query)
-      get("/payment_methods/search", params: query) { |response| validate_response(response, ['results', 0])}
-    end
-
-    def get_payment_methods
-      get("/payment_methods") { |response| validate_response(response, 'id')}
-    end
-
-    private
-
-    def validate_response(response, required_response_key)
-      puts response.json unless response.success?
-      ![500, 429].include?(response.code) || response.json.dig(*required_response_key)
-    end
-
-  end
-end
+module MpApi
+  class Client < Ac::Base
+    BASE_URL = "https://api.mercadopago.com/v1/"
+    MAX_RETRIES = 1
+    attr_reader :access_token
+    def initialize(access_token = MpApi.configuration.access_token)
+      @headers = {
+        "Content-Type" => "application/json",
+        "x-idempotency-key" => SecureRandom.uuid
+      }
+      super(access_token)
+    end
+
+    def create_payment(body)
+      post("/payments", body: body, headers: @headers) { |response| validate_response(response, "id") }
+    end
+
+    def get_payment(payment_id)
+      get("/payments/#{payment_id}") { |response| validate_response(response, "id") }
+    end
+
+    def update_payment(payment_id, body)
+      put("/payments/#{payment_id}", body: body, headers: @headers) { |response| validate_response(response, "id") }
+    end
+
+    def create_token(card_token_data)
+      post("/card_tokens", body: card_token_data, headers: @headers) { |response| validate_response(response, "id") }
+    end
+
+    def search_payment_methods(query)
+      get("/payment_methods/search", params: query) { |response| validate_response(response, ["results", 0]) }
+    end
+
+    def get_payment_methods
+      get("/payment_methods") { |response| validate_response(response, "id") }
+    end
+
+    private
+
+    def validate_response(response, required_response_key)
+      puts response.json unless response.success?
+      ![500, 429].include?(response.code) || response.json.dig(*required_response_key)
+    end
+  end
+end

data/lib/mp_api/payment.rb

@@ -1,8 +1,7 @@
 module MpApi
   class Payment
-
-    attr_reader :status_detail, :three_ds_info_creq, :three_ds_info_external_resource_url, :three_d_secure_mode, :id, :description, :date_approved, :date_created, :money_release_date, :payer_email, :payer_identification_type, :payer_identification_number, :payment_method, :payment_type, :qr_code, :qr_code_base_64, :transaction_id, :ticket_url, :status, :amount, :token, :issuer_id, :installments, :statement_descriptor, :items, :errors
-    def initialize(status_detail:nil, three_ds_info_creq:nil, three_ds_info_external_resource_url:nil, three_d_secure_mode:nil, id:nil, description:nil, date_approved:nil, date_created:nil, money_release_date:nil, payer_email:, payer_identification_type:, payer_identification_number:, payment_method:, payment_type:nil, qr_code:nil, qr_code_base_64:nil, transaction_id:nil, ticket_url:nil, status:nil, amount:, token:nil, issuer_id:nil, installments:nil, items:nil, statement_descriptor:nil, errors:nil)
+    attr_reader :status_detail, :three_ds_info_creq, :three_ds_info_external_resource_url, :three_d_secure_mode, :id, :description, :date_approved, :date_created, :money_release_date, :payer_email, :payer_identification_type, :payer_identification_number, :payment_method, :payment_type, :qr_code, :qr_code_base_64, :transaction_id, :ticket_url, :status, :amount, :token, :issuer_id, :installments, :statement_descriptor, :items, :error, :internal_error, :capture, :date_of_expiration
+    def initialize(payer_email:, payer_identification_type:, payer_identification_number:, payment_method:, amount:, status_detail: nil, three_ds_info_creq: nil, three_ds_info_external_resource_url: nil, three_d_secure_mode: nil, id: nil, description: nil, date_approved: nil, date_created: nil, money_release_date: nil, payment_type: nil, qr_code: nil, qr_code_base_64: nil, transaction_id: nil, ticket_url: nil, status: nil, token: nil, issuer_id: nil, installments: nil, items: nil, statement_descriptor: nil, error: nil, internal_error: nil, capture: nil, date_of_expiration: nil)
       @id = id
       @description = description
       @date_approved = date_approved
@@ -28,20 +27,33 @@ module MpApi
       @status_detail = status_detail
       @statement_descriptor = statement_descriptor
       @items = items
-      @errors = errors
+      @error = error
+      @internal_error = internal_error
+      @capture = capture
+      @date_of_expiration = date_of_expiration
     end
 
     def build_json
-      send("build_json_#{payment_method == 'pix' ? 'pix' : 'credit_card'}").except(:description)
+      send("build_json_#{(payment_method == "pix") ? "pix" : "credit_card"}").except(:description)
+    end
+
+    def build_update_json
+      {
+        # capture: capture,
+        status: status
+        # date_of_expiration: date_of_expiration,
+        # transaction_amount: amount
+      }.compact
     end
 
     def build_json_pix
       {
+        date_of_expiration: date_of_expiration,
         transaction_amount: amount,
         description: description,
         statement_descriptor: statement_descriptor,
         additional_info: {
-          items: @items
+          items: items
         },
         payment_method_id: payment_method,
         payer: {
@@ -51,50 +63,61 @@ module MpApi
             number: payer_identification_number
           }
         }
-      }
+      }.compact
     end
 
     def build_json_credit_card
       build_json_pix.merge({
+        capture: capture,
         token: token,
         issuer_id: issuer_id,
         installments: installments,
-        three_d_secure_mode: three_d_secure_mode ? 'optional' : 'not_supported'
-      })
+        three_d_secure_mode: three_d_secure_mode ? "optional" : "not_supported"
+      }.compact)
     end
-    
+
     def create
       response = Client.new.create_payment(JSON.dump(build_json))
       self.class.new(**self.class.build_hash(response.json))
     end
-        
+
+    def update attributes
+      attributes.each do |key, value|
+        instance_variable_set("@#{key}", value)
+      end
+      Client.new.update_payment(id, JSON.dump(build_update_json))
+      self.class.find_by_id(id)
+    end
+
     def self.find_by_id(payment_id)
       response = Client.new.get_payment(payment_id)
       new(**build_hash(response.json))
     end
 
     def self.build_hash json_response
+      payment_error = PaymentError.new(json_response: json_response)
       {
-        id: json_response.dig('id'),
-        description: json_response.dig('description'),
-        date_approved: json_response.dig('date_approved'),
-        date_created: json_response.dig('date_created'),
-        money_release_date: json_response.dig('money_release_date'),
-        payer_email: json_response.dig('payer', 'email'),
-        payer_identification_type: json_response.dig('payer', 'identification', 'type'),
-        payer_identification_number: json_response.dig('payer', 'identification', 'number'),
-        payment_method: json_response.dig('payment_method_id'),
-        payment_type: json_response.dig('payment_type_id'),
-        qr_code: json_response.dig('point_of_interaction', 'transaction_data', 'qr_code'),
-        qr_code_base_64: json_response.dig('point_of_interaction', 'transaction_data', 'qr_code_base64'),
-        three_ds_info_external_resource_url: json_response.dig('three_ds_info', 'external_resource_url'),
-        three_ds_info_creq: json_response.dig('three_ds_info', 'creq'),
-        transaction_id: json_response.dig('point_of_interaction', 'transaction_data', 'transaction_id'),
-        ticket_url: json_response.dig('point_of_interaction', 'transaction_data', 'ticket_url'),
-        status: json_response.dig('status'),
-        status_detail: json_response.dig('status_detail'),
-        amount: json_response.dig('transaction_amount'),
-        errors: PaymentError.new(json_response: json_response).errors
+        id: json_response.dig("id"),
+        description: json_response.dig("description"),
+        date_approved: json_response.dig("date_approved"),
+        date_created: json_response.dig("date_created"),
+        money_release_date: json_response.dig("money_release_date"),
+        payer_email: json_response.dig("payer", "email"),
+        payer_identification_type: json_response.dig("payer", "identification", "type"),
+        payer_identification_number: json_response.dig("payer", "identification", "number"),
+        payment_method: json_response.dig("payment_method_id"),
+        payment_type: json_response.dig("payment_type_id"),
+        qr_code: json_response.dig("point_of_interaction", "transaction_data", "qr_code"),
+        qr_code_base_64: json_response.dig("point_of_interaction", "transaction_data", "qr_code_base64"),
+        three_ds_info_external_resource_url: json_response.dig("three_ds_info", "external_resource_url"),
+        three_ds_info_creq: json_response.dig("three_ds_info", "creq"),
+        transaction_id: json_response.dig("point_of_interaction", "transaction_data", "transaction_id"),
+        ticket_url: json_response.dig("point_of_interaction", "transaction_data", "ticket_url"),
+        status: json_response.dig("status"),
+        status_detail: json_response.dig("status_detail"),
+        amount: json_response.dig("transaction_amount"),
+        error: payment_error.error,
+        internal_error: payment_error.internal_error
       }
     end
   end

data/lib/mp_api/payment_error.rb

@@ -1,131 +1,39 @@
 module MpApi
   class PaymentError
-    
     attr_reader :json_response
     def initialize(json_response:)
       @json_response = json_response
     end
 
-    def errors
-      rejected_payment_error || failed_payment_error
+    def error
+      rejected_payment_error
     end
-    
+
+    def internal_error
+      failed_payment_error
+    end
+
     private
-    
+
     def rejected_payment_error
-      return nil unless ['rejected'].include?(json_response['status'])
-      [message_by_status_detail(json_response['status_detail'])]
+      return nil unless ["rejected"].include?(json_response["status"])
+      message_by_status_detail(json_response["status_detail"])
     end
 
     def failed_payment_error
-      return nil unless json_response['error']
-      json_response['cause']&.map {|cause| message_by_error_code(cause['code']) || cause['description']}
+      return nil unless json_response["error"]
+      json_response["cause"].first["description"]
     end
 
     def message_by_status_detail(status_detail)
       {
-        'cc_rejected_bad_filled_other' => 'Recusado por erro no formulário.',
-        'cc_rejected_bad_filled_date' => 'Recusado por problema com a data de vencimento',
-        'cc_rejected_bad_filled_security_code' => 'Recusado por código de segurança inválido.',
-        'cc_rejected_insufficient_amount' => 'Recusado por quantia insuficiente.',
-        'cc_rejected_call_for_authorize' => 'Recusado, ligue para a administradora do cartão para autorizar.',
-        'cc_rejected_other_reason' => 'Recusado por erro geral'
-      }[status_detail]
+        "cc_rejected_bad_filled_other" => "Pagamento recusado.",
+        "cc_rejected_bad_filled_date" => "Pagamento recusado. Confira a data de validade do cartão.",
+        "cc_rejected_bad_filled_security_code" => "Pagamento recusado. Confira o código de segurança (CVV) do cartão.",
+        "cc_rejected_insufficient_amount" => "Pagamento recusado. Limite insuficiente.",
+        "cc_rejected_call_for_authorize" => "Pagamento recusado.",
+        "cc_rejected_other_reason" => "Pagamento recusado."
+      }[status_detail] || "Pagamento recusado."
     end
-
-    def message_by_error_code(code)
-      {
-        1 => "Erro nos parâmetros.",
-        3 => "O token deve ser de teste.",
-        5 => "É necessário fornecer seu access_token para prosseguir.",
-        23 => "Os seguintes parâmetros devem ter uma data válida e no formato (aaaa-MM-dd'T'HH:mm:ssz) date_of_expiration.",
-        1000 => "Número de linhas excedeu os limites.",
-        1001 => "O formato da data deve ser aaaa-MM-dd'T'HH:mm:ss.SSSZ.",
-        2001 => "Já foi enviada a mesma solicitação no último minuto.",
-        2002 => "Cliente não encontrado.",
-        2004 => "Falha ao enviar POST para a API de Transações do Gateway.",
-        2006 => "Token do cartão não encontrado.",
-        2007 => "Falha na conexão com a API de Token do Cartão.",
-        2009 => "O emissor do token do cartão não pode ser nulo.",
-        2011 => "Id do método de pagamento inválido.",
-        2034 => "Erro estranho do mercado pago de usuarios envolvidos, normalmente causado pelo email do pagador.",
-        2060 => "O cliente não pode ser igual ao coletor.",
-        2062 => "Token do cartão inválido.",
-        2067 => "Número de identificação do usuário inválido.",
-        2072 => "Valor inválido para transaction_amount.",
-        2077 => "Captura diferida não suportada.",
-        2123 => "Operadores inválidos envolvidos.",
-        2131 => "Não é possível inferir o Método de Pagamento.",
-        3000 => "Você deve fornecer o nome do titular do cartão com seus dados do cartão.",
-        3001 => "Você deve fornecer o id do emissor do cartão com seus dados do cartão.",
-        3003 => "Id do token do cartão inválido.",
-        3004 => "Parâmetro site_id inválido.",
-        3005 => "Ação inválida, o recurso está em um estado que não permite esta operação. Para mais informações, consulte o estado que o recurso possui.",
-        3006 => "Parâmetro id do token do cartão inválido.",
-        3007 => "O parâmetro client_id não pode ser nulo ou vazio.",
-        3008 => "Token do Cartão não encontrado.",
-        3009 => "client_id não autorizado.",
-        3010 => "Cartão não encontrado na lista branca.",
-        3011 => "Método de pagamento não encontrado.",
-        3012 => "Parâmetro comprimento do código de segurança inválido.",
-        3013 => "O parâmetro código de segurança é um campo obrigatório e não pode ser nulo ou vazio.",
-        3014 => "Parâmetro método de pagamento inválido.",
-        3015 => "Parâmetro comprimento do número do cartão inválido.",
-        3016 => "Parâmetro número do cartão inválido.",
-        3017 => "O parâmetro id do número do cartão não pode ser nulo ou vazio.",
-        3018 => "O parâmetro mês de vencimento não pode ser nulo ou vazio.",
-        3019 => "O parâmetro ano de vencimento não pode ser nulo ou vazio.",
-        3020 => "O parâmetro nome do titular do cartão não pode ser nulo ou vazio.",
-        3021 => "O parâmetro número do documento do titular do cartão não pode ser nulo ou vazio.",
-        3022 => "O parâmetro tipo de documento do titular do cartão não pode ser nulo ou vazio.",
-        3023 => "O parâmetro subtipo de documento do titular do cartão não pode ser nulo ou vazio.",
-        3024 => "Ação inválida - reembolso parcial não suportado para esta transação.",
-        3025 => "Código de autenticação inválido.",
-        3026 => "Id do cartão inválido para este id do método de pagamento.",
-        3027 => "Id do tipo de pagamento inválido.",
-        3028 => "Id do método de pagamento inválido.",
-        3029 => "Mês de vencimento do cartão inválido.",
-        3030 => "Ano de vencimento do cartão inválido.",
-        3031 => "Secure_code_id não pode ser nulo.",
-        3032 => "Comprimento inválido do código de segurança 3033 3034 - Validação do número do cartão inválida.",
-        4000 => "Atributo do cartão não pode ser nulo.",
-        4001 => "Atributo do id do método de pagamento não pode ser nulo.",
-        4002 => "Atributo do valor da transação não pode ser nulo.",
-        4003 => "Atributo do valor da transação deve ser numérico.",
-        4004 => "Atributo de parcelas não pode ser nulo.",
-        4005 => "Atributo de parcelas deve ser numérico.",
-        4006 => "Atributo do pagador está malformado.",
-        4007 => "Atributo do site_id não pode ser nulo.",
-        4012 => "Atributo do id do pagador não pode ser nulo.",
-        4013 => "Atributo do tipo de pagador não pode ser nulo.",
-        4015 => "Atributo do id de referência do método de pagamento não pode ser nulo.",
-        4016 => "Atributo do id de referência do método de pagamento deve ser numérico.",
-        4017 => "Atributo do status não pode ser nulo.",
-        4018 => "Atributo do id do pagamento não pode ser nulo.",
-        4019 => "Atributo do id do pagamento deve ser numérico.",
-        4020 => "Atributo notificaction_url deve ser uma URL válida.",
-        4021 => "Atributo notificaction_url deve ter menos de 500 caracteres.",
-        4022 => "Atributo metadata deve ser um JSON válido.",
-        4023 => "Atributo do valor da transação não pode ser nulo.",
-        4024 => "Atributo do valor da transação deve ser numérico.",
-        4025 => "Id do reembolso não pode ser nulo.",
-        4026 => "Valor do cupom inválido.",
-        4027 => "Atributo do id da campanha deve ser numérico.",
-        4028 => "Atributo do valor do cupom deve ser numérico.",
-        4029 => "Tipo de pagador inválido.",
-        4033 => "Número de parcelas inváido.",
-        4037 => "Valor da transação inválido.",
-        4038 => "A taxa de aplicação não pode ser maior que o valor da transação.",
-        4039 => "A taxa de aplicação não pode ser um valor negativo.",
-        4049 => "Atributo do valor da transação deve ser positivo.",
-        4050 => "O email do pagador deve ser um email válido.",
-        4051 => "O email do pagador deve ter menos de 254 caracteres.",
-        4390 => "O email do pagador deve ser um email válido.",
-        4084 => "issuer_id deve ser inteiro.",
-        6033 => "Usuário indisponível.",
-        7523 => "Data de vencimento inválida."
-      }[code]
-    end
-
   end
-end
+end

data/lib/mp_api/payment_method.rb

@@ -1,9 +1,7 @@
 module MpApi
-  
   class PaymentMethod
-  
     attr_reader :payment_method_id, :issuer_id, :installments, :errors
-    def initialize(payment_method_id: , issuer_id: , installments:, errors:nil)
+    def initialize(payment_method_id:, issuer_id:, installments:, errors: nil)
       @payment_method_id = payment_method_id
       @issuer_id = issuer_id
       @installments = installments
@@ -17,23 +15,21 @@ module MpApi
 
     def self.build_query(first_six_digits)
       {
-        marketplace: 'NONE',
-        status: 'active',
+        marketplace: "NONE",
+        status: "active",
         bins: first_six_digits
       }
     end
 
     def self.build_hash(response, credit)
-      payment_type_id = credit ? 'credit_card' : 'debit_card'
-      payment_method = response.dig('results')&.find {|pm| pm['payment_type_id'] == payment_type_id}
+      payment_type_id = credit ? "credit_card" : "debit_card"
+      payment_method = response.dig("results")&.find { |pm| pm["payment_type_id"] == payment_type_id }
       {
-        payment_method_id: payment_method&.dig('id'),
-        issuer_id: payment_method&.dig('issuer', 'id'),
-        installments: payment_method&.dig('payer_costs'),
-        errors: response.dig('message')
+        payment_method_id: payment_method&.dig("id"),
+        issuer_id: payment_method&.dig("issuer", "id"),
+        installments: payment_method&.dig("payer_costs"),
+        errors: response.dig("message")
       }
     end
-
   end
-
-end
+end

data/lib/mp_api/token.rb

@@ -1,9 +1,7 @@
 module MpApi
-  
   class Token
-    
     attr_reader :card_number, :expiration_year, :expiration_month, :security_code, :cardholder_name, :id, :errors
-    def initialize(card_number:, expiration_year:, expiration_month:, security_code:, cardholder_name:, id:nil, errors:nil)
+    def initialize(card_number:, expiration_year:, expiration_month:, security_code:, cardholder_name:, id: nil, errors: nil)
       @card_number = card_number
       @expiration_year = expiration_year
       @expiration_month = expiration_month
@@ -32,15 +30,14 @@ module MpApi
 
     def self.build_hash(response)
       {
-        id: response['id'],
-        expiration_year: response['expiration_year'],
-        expiration_month: response['expiration_month'],
-        cardholder_name: response.dig('cardholder', 'name'),
-        card_number: response['card_number'],
-        security_code: response['security_code'],
-        errors: response['error']
+        id: response["id"],
+        expiration_year: response["expiration_year"],
+        expiration_month: response["expiration_month"],
+        cardholder_name: response.dig("cardholder", "name"),
+        card_number: response["card_number"],
+        security_code: response["security_code"],
+        errors: response["error"]
       }
     end
-
   end
 end

data/lib/mp_api/version.rb

@@ -1,5 +1,5 @@
-# frozen_string_literal: true
-
-module MpApi
-  VERSION = "0.3.4"
-end
+# frozen_string_literal: true
+
+module MpApi
+  VERSION = "0.3.6"
+end

data/lib/mp_api.rb

@@ -7,22 +7,20 @@ require_relative "mp_api/payment_error"
 require_relative "mp_api/token"
 require_relative "mp_api/payment_method"
 require_relative "mp_api/version"
+
 module MpApi
   class Error < StandardError; end
 
   class RequestError < StandardError
-    def initialize(message="Request error")
+    def initialize(message = "Request error")
       super(message)
     end
   end
 
   class Configuration
     attr_accessor :access_token, :public_key
-
-    def initialize
-    end
   end
-  
+
   class << self
     attr_accessor :configuration
   end
@@ -31,5 +29,4 @@ module MpApi
     self.configuration ||= Configuration.new
     yield configuration
   end
-
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mp_api
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.3.6
 platform: ruby
 authors:
 - caio
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-01-04 00:00:00.000000000 Z
+date: 2024-01-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ac