mp_api 0.3.12 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7384cdb5d64721a848a2983efb3ae0ab04680bcccffe7397a33e1880b6a508df
-  data.tar.gz: 070e6dfc2fd2ac8fb54d3a19d4b2c8088600025d1faf8492baf91f5a8f17c614
+  metadata.gz: 14d24c337abe28eab714ae937b8cc427a8bfa7a6c63d1f97a3e81af62ce7c8ac
+  data.tar.gz: 32eeff608351f09cc4266392edef78cd60e6dbdbd5095b50034a79c8f1f4a5e7
 SHA512:
-  metadata.gz: a002584230be2d7e5e10ca80496f8973e04099a0fc0583701adaa78004429ceb092f1daaacb7c1d9cd051f64062d27e0bc99072b2c1ac3482ddd2bf8c0eb1904
-  data.tar.gz: 4cbcd8b268e08703e05662525ecdde23de3e49d9e7def904e7595dc8372da573327c978f09f01d3a22fd14b2517c200e8b3a8b7029767e3dac7f96d7f30ecbc7
+  metadata.gz: b4e8c968cc02439b3e73f21e4269098744586aab0540ec339bce6e2a02c9a8a3f302f32eba0c2e15b672450d53f2205434795bc26f4e48a7ff3761075868ec15
+  data.tar.gz: 16ecb53202057e817de0d3a80085f4f83359cffdc0e242c7b9bc0d264de974253802859b8e420fb7b720dd9cafe942e93026b6eb057e600242e4a82c688ee3b7

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/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, :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)
+    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)
       @id = id
       @description = description
       @date_approved = date_approved
@@ -11,6 +11,7 @@ module MpApi
       @payer_identification_type = payer_identification_type
       @payer_identification_number = payer_identification_number
       @payment_method = payment_method
+      @last_four_digits = last_four_digits
       @payment_type = payment_type
       @qr_code = qr_code
       @qr_code_base_64 = qr_code_base_64
@@ -106,6 +107,7 @@ module MpApi
         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"),
+        last_four_digits: json_response.dig("card", "last_four_digits"),
         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"),

data/lib/mp_api/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mp_api
 version: !ruby/object:Gem::Version
-  version: 0.3.12
+  version: 1.0.1
 platform: ruby
 authors:
-- caio
+- Todas Essas Coisas
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-01-24 00:00:00.000000000 Z
+date: 2024-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ac
@@ -43,13 +43,13 @@ files:
 - 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 +65,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.9
 signing_key: 
 specification_version: 4
 summary: ''