{"id":19545180,"url":"https://github.com/mercadopago/sdk-ruby","last_synced_at":"2025-04-05T05:05:57.769Z","repository":{"id":5195206,"uuid":"6370287","full_name":"mercadopago/sdk-ruby","owner":"mercadopago","description":"Mercado Pago's Official Ruby SDK","archived":false,"fork":false,"pushed_at":"2024-02-06T21:59:45.000Z","size":3421,"stargazers_count":66,"open_issues_count":0,"forks_count":51,"subscribers_count":42,"default_branch":"master","last_synced_at":"2024-03-25T22:10:14.055Z","etag":null,"topics":["backend-sdk","mercadopago","ruby","sdk"],"latest_commit_sha":null,"homepage":"https://developers.mercadopago.com/","language":"Ruby","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"NYTimes/objective-c-style-guide","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mercadopago.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-10-24T13:25:58.000Z","updated_at":"2024-06-18T19:58:27.986Z","dependencies_parsed_at":"2022-09-09T13:22:17.403Z","dependency_job_id":"a2eab8fe-7e7a-442f-b2b8-0f21417444ff","html_url":"https://github.com/mercadopago/sdk-ruby","commit_stats":{"total_commits":99,"total_committers":19,"mean_commits":"5.2105263157894735","dds":0.7474747474747474,"last_synced_commit":"6c95e427b973bcbc728fb2cf93284684e2e587bc"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mercadopago%2Fsdk-ruby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mercadopago%2Fsdk-ruby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mercadopago%2Fsdk-ruby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mercadopago%2Fsdk-ruby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mercadopago","download_url":"https://codeload.github.com/mercadopago/sdk-ruby/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247289426,"owners_count":20914464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend-sdk","mercadopago","ruby","sdk"],"created_at":"2024-11-11T03:36:12.510Z","updated_at":"2025-04-05T05:05:57.757Z","avatar_url":"https://github.com/mercadopago.png","language":"Ruby","readme":"# Mercado Pago SDK for Ruby\n\n[![Gem](https://img.shields.io/gem/v/mercadopago-sdk)](https://rubygems.org/gems/mercadopago-sdk)\n[![Gem](https://img.shields.io/gem/dt/mercadopago-sdk)](https://rubygems.org/gems/mercadopago-sdk)\n![GitHub](https://img.shields.io/github/license/mercadopago/sdk-ruby)\n\nThis library provides developers with a simple set of bindings to help you integrate Mercado Pago API to a website and start receiving payments.\n\n## 💡 Requirements\n\nRuby version **2.3 or greater**.\n\n## 📲 Installation \n\nRun ```gem install mercadopago-sdk```\n\n## 🌟 Getting Started\n\nFirst time using Mercado Pago? Create your [Mercado Pago account](https://www.mercadopago.com).\n\nCopy your `Access Token` in the [credentials panel](https://www.mercadopago.com/developers/panel/app) and replace the text `YOUR_ACCESS_TOKEN` with it.\n\n### Simple usage\n\nTo generate a `card token` read the [Checkout API](https://www.mercadopago.com/developers/en/guides/online-payments/checkout-api/introduction) documentation.\n\n```ruby\nrequire 'mercadopago'\n\nsdk = Mercadopago::SDK.new('YOUR_ACCESS_TOKEN')\n\ncustom_headers = {\n 'x-idempotency-key': '\u003cSOME_UNIQUE_VALUE\u003e'\n}\n\ncustom_request_options = Mercadopago::RequestOptions.new(custom_headers: custom_headers)\n\norder_data = {\n  type: 'online',\n  total_amount: '1000.00',\n  external_reference: 'ext_ref_1234',\n  capture_mode: 'automatic',\n  transactions: {\n    payments: [\n      {\n        amount: '1000.00',\n        payment_method: {\n          id: 'master',\n          type: 'credit_card',\n          token: '\u003cCARD_TOKEN\u003e',\n          installments: 1,\n          statement_descriptor: 'Store name'\n        }\n      }\n    ]\n  },\n  processing_mode: 'automatic',\n  description: 'some description',\n  payer: {\n    email: '\u003cPAYER_EMAIL\u003e',\n    first_name: 'John',\n    last_name: 'Doe',\n    identification: {\n      type: 'CPF',\n      number: '00000000000'\n    }\n  }\n}\n\nresult = sdk.order.create(order_data, custom_request_options)\norder = result[:response]\n\nputs order\n```\n\n### Per-request configuration\n\nAll methods that make API calls accept an optional `RequestOptions` object. This can be used to configure some special options of the request, such as changing credentials or custom headers.\n\n```ruby\nrequire 'mercadopago'\n\nrequest_options = Mercadopago::RequestOptions.new(access_token: 'YOUR_ACCESS_TOKEN')\n# ...\n\nresult = sdk.payment.create(payment_data, request_options: request_options)\npayment = result[:response]\n```\n\n## 📚 Documentation \n\nVisit our Dev Site for further information regarding:\n - [Developer Docs](https://www.mercadopago.com/developers/en/docs)\n - [Checkout Bricks](https://www.mercadopago.com/developers/en/docs/checkout-bricks/landing)\n - [Checkout Pro](https://www.mercadopago.com/developers/en/guides/online-payments/checkout-pro/introduction)\n - [Checkout API](https://www.mercadopago.com/developers/en/guides/online-payments/checkout-api/introduction)\n\nCheck our official code reference to explore all available functionalities.\n\n## 🤝 Contributing\n\nAll contributions are welcome, ranging from people wanting to triage issues, others wanting to write documentation, to people wanting to contribute code.\n\nPlease read and follow our [contribution guidelines](CONTRIBUTING.md). Contributions not following this guidelines will be disregarded. The guidelines are in place to make all of our lives easier and make contribution a consistent process for everyone.\n\n## ❤️ Support\n\nIf you require technical support, please contact our support team at [developers.mercadopago.com](https://developers.mercadopago.com).\n\n## 🏻 License\n\n```\nMIT license. Copyright (c) 2021 - Mercado Pago / Mercado Libre\nFor more information, see the LICENSE file.\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmercadopago%2Fsdk-ruby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmercadopago%2Fsdk-ruby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmercadopago%2Fsdk-ruby/lists"}