mp_api 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f698c10976e005ed5fb524e6ff6a92005ae477ce7218a54b29783849fbe85048
-  data.tar.gz: cdce89a4463b792079923cb701ebe92a1b2b4c32e8a9a6aab67cd5660114921a
+  metadata.gz: acb1327c5e7bdeb10e34f09b348fff419d38451506f7f4e18f75bdeeceec5294
+  data.tar.gz: 170333900c1568e4937e0dbd5b333ea764f1f548871acaab5dd1825e238c6605
 SHA512:
-  metadata.gz: c7f8e4fa1fb084aa51134a39451d0b644ac00a821bbfc367c76bbe491e9ce2ce31e23ba1f4f535b5879a16186bc4d691d2c3ae90f8bd7b1f1dbb71620fc66c6f
-  data.tar.gz: f3e034f371edd0f4203798d31c7879e52f9393b5165eb65fa26f44a2383849f1317b2d0971d2b730da471315b077e9e629837805097a2b1049cdc7c8d56f5731
+  metadata.gz: 77a6f9bc3cdce5dfddf47c90dc2de04af4b3f0da903cbd502c41325cdf910f9573a25757f22ef5dd99bcd822841cfd9cd23aa88950fac49315539f45ae4569cc
+  data.tar.gz: de19a66ddb638012c114f1df58b679affe37be5345ab418253c37bb8376f99b0634181353a26ce3ca61c5dca093c5fa0eec926a39fc8fc32beccb6208b63234c

data/README.md

@@ -1,19 +1,86 @@
 # MpApi
 
-## Installation
+Wrapper de integração com a API do Mercado Pago.
 
-Add solidus_bling to your Gemfile:
+[Documentação API Mercado Pago](https://www.mercadopago.com.br/developers/pt/docs)
+
+### Funcionalidades:
+- Criar pagamentos Pix ou cartão de crédito
+- Gerar token único para um cartão de crédito
+- Atualizar e encontrar pagamentos pelo ID
+- Buscar bandeira do cartão a partir dos seis primeiros digitos
+
+## Instalação
+
+Adicionar mp_api no Gemfile:
 
 ```ruby
 gem 'mp_api'
 ```
+ou
+```shell
+bundle add mp_api
+```
 
-Bundle your dependencies and run the installation generator:
+Instalar a gem:
 
 ```shell
 bin/rails generate mp_api:install
 ```
 
-## License
+## Uso
+
+Configurar access_token no initializer ou direto no código:
+```ruby
+MpApi.configure do |config|
+  config.access_token = "ACCESS_TOKEN"
+end
+```
 
-Copyright (c) 2023 CaioGarcia1, released under the New BSD License.
+### Exemplos de criação de pagamento
+#### Cartão de crédito
+```ruby
+# Criação de um token para cartão teste
+token = MpApi::Token.new(
+  card_number: "5031433215406351",
+  expiration_year: "2025",
+  expiration_month: "11",
+  security_code: "123",
+  cardholder_name: "APRO"
+).create
+puts token.id # c8ad2335a9bb58e585a8c35bfd9f29ad
+
+# Encontra o ID e a bandeira do cartão
+payment_method = MpApi::PaymentMethod.find_by_first_six_digits("503143")
+puts payment_method.payment_method_id # "master"
+
+# Criação do pagamento
+payment = MpApi::Payment.new(
+  amount: 140.0,
+  payment_method: payment_method.payment_method_id,
+  payer_email: "email@example.com",
+  payer_identification_type: "CPF",
+  payer_identification_number: "12345678909",
+  token: token.id,
+  issuer_id: payment_method.issuer_id,
+  installments: 1,
+  three_d_secure_mode: true
+).create
+
+puts payment.id # 1318474186
+puts payment.status # "approved"
+```
+
+#### Pix
+```ruby
+# Criação do pagamento
+payment = MpApi::Payment.new(
+  payer_email: "email@example.com",
+  payer_identification_type: "CPF",
+  payer_identification_number: "12345678909",
+  payment_method: "pix",
+  amount: 140.0
+).create
+puts payment.id # 1318474264
+puts payment.status # "pending"
+```

data/lib/mp_api/card.rb

@@ -0,0 +1,46 @@
+module MpApi
+  class Card
+    attr_reader :token, :customer_id, :external_id, :cardholder_name, :expiration_month, :expiration_year, :first_six_digits, :last_four_digits, :issuer_id, :mp_payment_method_id, :error, :error_detail
+
+    def initialize(token: nil, customer_id: nil, external_id: nil, cardholder_name: nil, expiration_month: nil, expiration_year: nil, first_six_digits: nil, last_four_digits: nil, issuer_id: nil, mp_payment_method_id: nil, error: nil, error_detail: nil)
+      @token = token
+      @customer_id = customer_id
+      @external_id = external_id
+      @cardholder_name = cardholder_name
+      @expiration_month = expiration_month
+      @expiration_year = expiration_year
+      @first_six_digits = first_six_digits
+      @last_four_digits = last_four_digits
+      @issuer_id = issuer_id
+      @mp_payment_method_id = mp_payment_method_id
+      @error = error
+      @error_detail = error_detail
+    end
+    
+    def build_json
+      {
+        token: token
+      }
+    end
+
+    def create
+      response = Client.new.create_card(customer_id, JSON.dump(build_json))
+      self.class.new(**self.class.build_hash(response.json))
+    end
+
+    def self.build_hash(response)
+      {
+        external_id: response.dig("id"),
+        cardholder_name: response.dig("cardholder", "name"),
+        expiration_month: response.dig("expiration_month"),
+        expiration_year: response.dig("expiration_year"),
+        first_six_digits: response.dig("first_six_digits"),
+        last_four_digits: response.dig("last_four_digits"),
+        issuer_id: response.dig("issuer", "id"),
+        mp_payment_method_id: response.dig("payment_method", "id"),
+        error: response.dig("message"),
+        error_detail: response.dig("cause")
+      }
+    end
+  end
+end

data/lib/mp_api/client.rb

@@ -35,6 +35,14 @@ module MpApi
       get("/payment_methods") { |response| validate_response(response, "id") }
     end
 
+    def create_customer(body)
+      post("/customers", body: body, headers: @headers) { |response| validate_response(response, "id") }
+    end
+
+    def create_card(customer_id, body)
+      post("/customers/#{customer_id}/cards", body: body, headers: @headers) { |response| validate_response(response, "id") }
+    end
+
     private
 
     def validate_response(response, required_response_key)

data/lib/mp_api/customer.rb

@@ -0,0 +1,54 @@
+module MpApi
+  class Customer
+
+    attr_reader :external_id, :email, :first_name, :identification_type, :identification_number, :phone_area_code, :phone_number, :status, :error, :error_detail
+    def initialize(external_id: nil, email:, first_name: nil, identification_type:, identification_number:, phone_area_code: "55", phone_number: nil, status: nil, error: nil, error_detail: nil)
+      @external_id = external_id
+      @email = email
+      @first_name = first_name
+      @identification_type = identification_type
+      @identification_number = identification_number
+      @phone_area_code = phone_area_code
+      @phone_number = phone_number
+      @status = status
+      @error = error
+      @error_detail = error_detail
+    end
+
+    def build_json
+      {
+        email: email,
+        first_name: first_name,
+        identification: {
+          type: identification_type,
+          number: identification_number
+        },
+        phone: {
+          area_code: phone_area_code,
+          number: phone_number
+        }
+      }
+    end
+
+    def create
+      response = Client.new.create_customer(JSON.dump(build_json))
+      self.class.new(**self.class.build_hash(response.json))
+    end
+
+    def self.build_hash(response)
+      {
+        external_id: response.dig("id"),
+        email: response.dig("email"),
+        first_name: response.dig("first_name"),
+        identification_type: response.dig("identification", "type"),
+        identification_number: response.dig("identification", "number"),
+        phone_area_code: response.dig("phone", "area_code"),
+        phone_number: response.dig("phone", "number"),
+        status: response.dig("status"),
+        error: response.dig("message"),
+        error_detail: response.dig("cause")
+      }
+    end
+
+  end
+end

data/lib/mp_api/payment.rb

@@ -1,7 +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, :last_four_digits, :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:, last_four_digits: nil, 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)
+    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, :last_four_digits, :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, :saved_card, :customer_id
+    def initialize(payer_email:, payer_identification_type:, payer_identification_number:, payment_method:, last_four_digits: nil, 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, saved_card: false, customer_id: nil)
       @id = id
       @description = description
       @date_approved = date_approved
@@ -32,6 +32,8 @@ module MpApi
       @internal_error = internal_error
       @capture = capture
       @date_of_expiration = date_of_expiration
+      @saved_card = saved_card
+      @customer_id = customer_id
     end
 
     def build_json
@@ -68,13 +70,25 @@ module MpApi
     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"
-      }.compact)
+      if saved_card
+        {
+          transaction_amount: amount,
+          token: token,
+          installments: installments,
+          payer: {
+            type: "customer",
+            id: customer_id
+          }
+        }
+      else
+        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"
+        }.compact)
+      end
     end
 
     def create

data/lib/mp_api/version.rb

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

data/lib/mp_api.rb

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
 require "ac"
+require "securerandom"
 require_relative "mp_api/client"
 require_relative "mp_api/payment"
 require_relative "mp_api/payment_error"
 require_relative "mp_api/token"
 require_relative "mp_api/payment_method"
+require_relative "mp_api/customer"
+require_relative "mp_api/card"
 require_relative "mp_api/version"
 
 module MpApi

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mp_api
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
-- caio
+- Todas Essas Coisas
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-05-10 00:00:00.000000000 Z
+date: 2024-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ac
@@ -37,19 +37,21 @@ files:
 - lib/generators/mp_api/install/install_generator.rb
 - lib/generators/mp_api/install/templates/initializer.rb
 - lib/mp_api.rb
+- lib/mp_api/card.rb
 - lib/mp_api/client.rb
+- lib/mp_api/customer.rb
 - lib/mp_api/payment.rb
 - lib/mp_api/payment_error.rb
 - lib/mp_api/payment_method.rb
 - lib/mp_api/token.rb
 - lib/mp_api/version.rb
-homepage: https://github.com/CaioGarcia1/mp_api
+homepage: https://github.com/todasessascoisas/mp_api
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/CaioGarcia1/mp_api
-  source_code_uri: https://github.com/CaioGarcia1/mp_api
-  changelog_uri: https://github.com/CaioGarcia1/mp_api
+  homepage_uri: https://github.com/todasessascoisas/mp_api
+  source_code_uri: https://github.com/todasessascoisas/mp_api
+  changelog_uri: https://github.com/todasessascoisas/mp_api
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -65,7 +67,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.10
+rubygems_version: 3.5.11
 signing_key: 
 specification_version: 4
 summary: ''