{"id":15288843,"url":"https://github.com/gilcierweb/picpay","last_synced_at":"2026-04-17T09:31:40.110Z","repository":{"id":56888048,"uuid":"373966422","full_name":"gilcierweb/picpay","owner":"gilcierweb","description":"PicPay - E-commerce Public API","archived":false,"fork":false,"pushed_at":"2021-06-04T21:49:57.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-25T21:47:43.413Z","etag":null,"topics":["ecommerce","ruby","ruby-on-rails"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gilcierweb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2021-06-04T21:49:16.000Z","updated_at":"2021-06-05T00:26:59.000Z","dependencies_parsed_at":"2022-08-21T00:50:56.666Z","dependency_job_id":null,"html_url":"https://github.com/gilcierweb/picpay","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gilcierweb/picpay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gilcierweb%2Fpicpay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gilcierweb%2Fpicpay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gilcierweb%2Fpicpay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gilcierweb%2Fpicpay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gilcierweb","download_url":"https://codeload.github.com/gilcierweb/picpay/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gilcierweb%2Fpicpay/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31923090,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T09:10:15.403Z","status":"ssl_error","status_checked_at":"2026-04-17T09:10:14.455Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["ecommerce","ruby","ruby-on-rails"],"created_at":"2024-09-30T15:53:22.327Z","updated_at":"2026-04-17T09:31:40.090Z","avatar_url":"https://github.com/gilcierweb.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PicPay - E-commerce Public API\n\n[![Gem Version](https://badge.fury.io/rb/picpay.svg)](https://badge.fury.io/rb/picpay)\n[![Build Status](https://travis-ci.org/gilcierweb/picpay.svg?branch=master)](https://travis-ci.org/gilcierweb/picpay)\n[![Maintainability](https://api.codeclimate.com/v1/badges/8ae01e6d34f3aaf85132/maintainability)](https://codeclimate.com/github/gilcierweb/picpay/maintainability)\n[![Test Coverage](https://api.codeclimate.com/v1/badges/8ae01e6d34f3aaf85132/test_coverage)](https://codeclimate.com/github/gilcierweb/picpay/test_coverage)\n\nPicPay é o app que faz com que seus pagamentos sejam mais simples e rápidos, do jeito que você precisa. Com o PicPay você recebe e envia dinheiro para outras pessoas, paga contas, estabelecimentos, compra créditos para o celular e muito mais. Tudo isso na hora, direto do seu celular.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'picpay'\n\n# or\ngem 'picpay', :git =\u003e 'https://github.com/gilcierweb/picpay'\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install picpay\n\n## Usage\n\n\n```ruby\n\n# Seller\npicpay_token = 'my_picpay_token'\nseller_token = 'my_seller_token'\napi_url = 'https://appws.picpay.com/ecommerce/public/payments' # optional\n\npicpay = Picpay::Picpay.new(picpay_token, seller_token)\n\n# Buyer\npicpay.first_name = 'Fulano'\npicpay.last_name = 'Da Silva Sousa'\npicpay.document = '123.456.789-10'\npicpay.email = 'teste@gilcierweb.com.br'\npicpay.phone = '+55 85 12345-6789'\n\n# Payment\npicpay.reference_id = '102030'\npicpay.callback_url = 'http://www.sualoja.com.br/callback'\npicpay.return_url = 'http://www.sualoja.com.br/cliente/pedido/102030' # optional\npicpay.value = 45.55 # format decimal\npicpay.expires_at = '20/09/2022 00:00 -03:00' # optional gem convert to format correct ISO 8601 ex: 2022-05-01T16:00:00-03:00\n\n# Payment Request\npayment_request = picpay.payments()\npayment_request.status\n# =\u003e 200\npayment_request.headers\n# =\u003e {\"server\"=\u003e\"app.picpay.com\", \"content-type\"=\u003e\"application/json; charset=utf-8\"...\npayment_request.body\nresponse = payment_request.body.force_encoding('ASCII-8BIT').force_encoding('UTF-8') # optional case error utf-8\n# =\u003e \"{referenceId: \"102030\"...\n\nreference_id = '102030'\nauthorization_id = '555008cef7f321d00ef236333'\n\n#Payment Cancellation \npayment_cancellation = picpay.payments_cancellations(reference_id, authorization_id)\npayment_cancellation.status\n# =\u003e 200\npayment_cancellation.headers\n# =\u003e {\"server\"=\u003e\"app.picpay.com\", \"content-type\"=\u003e\"application/json; charset=utf-8\"...\npayment_cancellation.body\nresponse = payment_cancellation.body.force_encoding('ASCII-8BIT').force_encoding('UTF-8') # optional case error utf-8\n\n# =\u003e \"{referenceId: \"102030\"...\n\n# Payment Status\npayment_status = picpay.payments_status(reference_id)\npayment_status.status\n# =\u003e 200\npayment_status.headers\n# =\u003e {\"server\"=\u003e\"app.picpay.com\", \"content-type\"=\u003e\"application/json; charset=utf-8\"...\npayment_status.body\nresponse = payment_status.body.force_encoding('ASCII-8BIT').force_encoding('UTF-8') # optional case error utf-8\n# =\u003e \"{referenceId: \"102030\"...\n```\n\n## Example of Payment Request (JSON)\n\n```json\n{\n\n    \"referenceId\": \"102030\",\n    \"callbackUrl\": \"http://www.sualoja.com.br/callback\",\n    \"returnUrl\": \"http://www.sualoja.com.br/cliente/pedido/102030\",\n    \"value\": 20.51,\n    \"expiresAt\": \"2022-05-01T16:00:00-03:00\",\n    \"buyer\": \n\n    {\n        \"firstName\": \"Fulano\",\n        \"lastName\": \"Da Silva Sousa\",\n        \"document\": \"123.456.789-10\",\n        \"email\": \"teste@gilcierweb.com.br\",\n        \"phone\": \"+55 27 12345-6789\"\n    }\n\n}\n```\n\n## Example of Payment Response (JSON)\n\n```json\n{\n\n    \"referenceId\": \"102030\",\n    \"paymentUrl\": \"https://app.picpay.com/checkout/NWFmMGRjNmViZDc0Y2EwMDMwNzZlYzEw\",\n    \"expiresAt\": \"2022-05-01T16:00:00-03:00\",\n    \"qrcode\": \n\n    {\n        \"content\": \"https://app.picpay.com/checkout/NWNlYzMxOTM1MDg1NGEwMDIwMzUxODcy\",\n        \"base64\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZAAAAGQCAIAAAAP3aGbAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAIHklEQVR4nO3dwW4bORRFQcfI/3+yMYsBZmfCYTjUO62qbRC5LckHvbhg//r6+voAKPh89QUA/JRgARmCBWQIFpAhWECGYAEZggVkCBaQIVhAhmABGYIFZAgWkCFYQIZgARmCBWQIFpAhWECGYAEZggVkCBaQIVhAhmABGYIFZAgWkCFYQIZgARmCBWQIFpAhWECGYAEZggVkCBaQIVhAhmABGYIFZAgWkCFYQIZgARmCBWQIFpAhWECGYAEZggVkCBaQIVhAhmABGYIFZAgWkCFYQIZgARm/X30B3/r8DMf06+vru3/a+70WL7jn+GUsXnDv4o+/4M2f9dRv78uF31bg3QgWkCFYQIZgARmCBWQIFpAhWECGYAEZc4ejC0OGbUMmoHuOT1sX9maZQ+amx19wyBcgOm1NXjTwngQLyBAsIEOwgAzBAjIEC8gQLCBDsICM5HB04fgc7g0Pt7y5hxxy8TdfcGH+u/Fy7rCADMECMgQLyBAsIEOwgAzBAjIEC8gQLCDjacPRtCGHW96cL+4dfHrz7NDjl8HfcIcFZAgWkCFYQIZgARmCBWQIFpAhWECGYAEZhqMNNx8fv3DzAfdDnizPKO6wgAzBAjIEC8gQLCBDsIAMwQIyBAvIECwg42nD0fnjwPQZm8cd36+mPfX3OsgdFpAhWECGYAEZggVkCBaQIVhAhmABGYIFZCSHozeXjcd5YPoPHX83hryH6W/vy3nvgAzBAjIEC8gQLCBDsIAMwQIyBAvIECwg49dTZ4dF8/eQN48wvXnxe/zt3OcOC8gQLCBDsIAMwQIyBAvIECwgQ7CADMECMuYOR28ezDjkQfDpcy+Pv4fHDZnR7r3gnvnfwz/lDgvIECwgQ7CADMECMgQLyBAsIEOwgAzBAjLmDkePG7KUG3L85nE3Z7RD5qZDPsohG+A73GEBGYIFZAgWkCFYQIZgARmCBWQIFpAhWEDG71dfwLeGrPIW3mqw9zeGvFFDzvOc/8WezB0WkCFYQIZgARmCBWQIFpAhWECGYAEZggVkzD1xdMjacM/NcWD6jdoz//DY4x/lkBd8OXdYQIZgARmCBWQIFpAhWECGYAEZggVkCBaQMXc4etzNVd5xQ572fnO++Iaf1/Gf9TzusIAMwQIyBAvIECwgQ7CADMECMgQLyBAsIMOj6m//rD1DHrO+kN5D3tyvHr+M+d/eg9xhARmCBWQIFpAhWECGYAEZggVkCBaQIVhAxtwTR4fM4eZfxpDR40J6U3r8C3DzBcf+dW9zhwVkCBaQIVhAhmABGYIFZAgWkCFYQIZgARlzTxzd89Tntt/01JHqzcfH8z/xOQEZggVkCBaQIVhAhmABGYIFZAgWkCFYQEbyxNEhxznuveBxQ3aeQ15wyP9amL9fHduED3dYQIhgARmCBWQIFpAhWECGYAEZggVkCBaQMXc4uvCGjz5fmL+HXEgfEPrUK5zchBFvK8BPCBaQIVhAhmABGYIFZAgWkCFYQIZgARlzH1WfPupzYcjOc2HvZw0ZIqankkNOUp3MHRaQIVhAhmABGYIFZAgWkCFYQIZgARmCBWTMHY4uPPUJ7HuGbEoXhlzGnvTFP29T6g4LyBAsIEOwgAzBAjIEC8gQLCBDsIAMwQIy5j6q/uaw7eZxjkOOFV24+RT7IfPFIR/lkG3zZO6wgAzBAjIEC8gQLCBDsIAMwQIyBAvIECwgI3ni6M0V5UJ6UnjT8ct46qj45mUsTJ6bjvhCA/yEYAEZggVkCBaQIVhAhmABGYIFZAgWkDH3xNE9N5dyQ+aLx6WP+hxi/jp0YXITpn/wAP8RLCBDsIAMwQIyBAvIECwgQ7CADMECMpLD0fkPTHc+5EBDZpkL88+wfTl3WECGYAEZggVkCBaQIVhAhmABGYIFZAgWkDF3ODpk8zbkcMs33K8OeeeHuPn2jm3ChzssIESwgAzBAjIEC8gQLCBDsIAMwQIyBAvImDscfaqbp5su3Dzc8uZlLMx/pPuQye5k7rCADMECMgQLyBAsIEOwgAzBAjIEC8gQLCDj96sv4FvpAycXW76bU8n5P2vvU745Ut0TPc9zvnAUgHcjWECGYAEZggVkCBaQIVhAhmABGYIFZMwdji4Mmd49ddo6/2TOheMj1T1DfuUhfykHhf/kgHcjWECGYAEZggVkCBaQIVhAhmABGYIFZCSHowvp0ePC8cfHH/+9hixRhxwretzx3ys6N3WHBWQIFpAhWECGYAEZggVkCBaQIVhAhmABGU8bjs43ZG148wX3/teQs0MXhgwshyyH7xjxwQP8hGABGYIFZAgWkCFYQIZgARmCBWQIFpBhONpwfOZ3/JjKhZtz04WbFz//Z0W90a8K1AkWkCFYQIZgARmCBWQIFpAhWECGYAEZTxuORs9R/Nfxx5EPeTeGXPze23v80M4hx8BGDyN1hwVkCBaQIVhAhmABGYIFZAgWkCFYQIZgARnJ4ehTj1icv+WbfyTm/J3nwvE3anHxQ75Rf+qZf/nAIwkWkCFYQIZgARmCBWQIFpAhWECGYAEZv6L7MeANucMCMgQLyBAsIEOwgAzBAjIEC8gQLCBDsIAMwQIyBAvIECwgQ7CADMECMgQLyBAsIEOwgAzBAjIEC8gQLCBDsIAMwQIyBAvIECwgQ7CADMECMgQLyBAsIEOwgAzBAjIEC8gQLCBDsIAMwQIyBAvIECwgQ7CADMECMgQLyBAsIEOwgAzBAjIEC8gQLCBDsIAMwQIyBAvIECwgQ7CADMECMgQLyBAsIOMfNhb2ttAasncAAAAASUVORK5CYII=\"\n    }\n\n}\n```\n\n## Example of Payment Cancellation Request (JSON)\n\n```json\n{\n\n    \"authorizationId\": \"555008cef7f321d00ef236333\"\n\n}\n```\n\n## Example of Payment Cancellation Response (JSON)\n\n```json\n{\n\n    \"referenceId\": \"102030\",\n    \"cancellationId\": \"5b008cef7f321d00ef236444\"\n\n}\n```\n\n## Example of Payment Status Request (JSON)\n\n\n```shell\nget https://appws.picpay.com/ecommerce/public/payments/{referenceId}/status\n```\n\n## Example of Payment Status Response (JSON)\n\n```json\n{\n\n    \"authorizationId\": \"555008cef7f321d00ef236333\",\n    \"referenceId\": \"102030\",\n    \"status\": \"paid\"\n\n}\n```\n## Example of Payment Notification Request (JSON)\n\n```shell\npost http://www.sualoja.com.br/callback\n```\n## Example of Payment Notification Response (JSON)\n\n```json\n{\n\n    \"referenceId\": \"102030\",\n    \"authorizationId\": \"5b01780ba8914c001a007673\"\n\n}\n```\nreturn status 200 in your api callback\n\n## Doação / Donate\nDoar com PagSeguro 5,00, 10,00, 15,00, 20,00, 30,00, 40,00 ou outro valor\n\nhttps://pag.ae/bmgSGGm\n\n[![](https://raw.github.com/gilcierweb/shopfacil/master/examples/image/clique-para-doar-qualquer-quantia.jpg)](https://pag.ae/bmgSGGm)\n\n## Consultoria / Consulting\n\nhttp://gilcierweb.com.br\n\n## Site\n\nhttp://gilcierweb.com.br\n\n## PicPay Site\nhttps://www.picpay.com/site\n\n## PicPay Documentation API\nhttps://ecommerce.picpay.com/doc/\n\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/picpay. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\n## Code of Conduct\n\nEveryone interacting in the Picpay project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/picpay/blob/master/CODE_OF_CONDUCT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgilcierweb%2Fpicpay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgilcierweb%2Fpicpay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgilcierweb%2Fpicpay/lists"}