{"id":18613051,"url":"https://github.com/eduzz/ecommerce-integration-form","last_synced_at":"2025-11-03T01:30:27.424Z","repository":{"id":32997788,"uuid":"148467122","full_name":"eduzz/ecommerce-integration-form","owner":"eduzz","description":null,"archived":false,"fork":false,"pushed_at":"2022-02-12T14:29:44.000Z","size":697,"stargazers_count":1,"open_issues_count":8,"forks_count":1,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-01-27T18:47:55.624Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/eduzz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-12T11:06:35.000Z","updated_at":"2019-05-06T15:12:42.000Z","dependencies_parsed_at":"2022-08-07T19:16:49.028Z","dependency_job_id":null,"html_url":"https://github.com/eduzz/ecommerce-integration-form","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduzz%2Fecommerce-integration-form","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduzz%2Fecommerce-integration-form/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduzz%2Fecommerce-integration-form/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduzz%2Fecommerce-integration-form/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eduzz","download_url":"https://codeload.github.com/eduzz/ecommerce-integration-form/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239406441,"owners_count":19633024,"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":[],"created_at":"2024-11-07T03:19:41.962Z","updated_at":"2025-11-03T01:30:27.397Z","avatar_url":"https://github.com/eduzz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EDUZZ - Api Ecommerce JavaScript\r\n\r\nSolução criada pela Eduzz com o objetivo de fornecer uma implementação fácil e rápida para criação de conteúdos de valores variáveis.\r\n\r\n- Altere o valor do seu Produto;\r\n- Altere informações básicas do seu Produto;\r\n- Receba informaões básicas dos seus clientes;\r\n\r\n# Implementação \r\n\r\n\\\r\nA *Api Ecommerce JavaScript* fornecida pela *Eduzz* necessita apenas de **HTML e JavaScript, padrão em qualquer webpage**.\r\n\r\nFaça o download deste repositório e **inclua no seu projeto o arquivo** `/dist/index.min.js`.\r\n\r\n```html\r\n\u003chtml\u003e\r\n    ...\r\n    \u003cbody\u003e\r\n        ...\r\n        \u003cscript type=\"text/javascript\" src=\"dist/index.min.js\"\u003e\u003c/script\u003e\r\n    \u003c/body\u003e\r\n\u003c/html\u003e\r\n```\r\n\r\n### Formulário de Dados\r\nSeu site irá receber as informações em JavaScript através de um formulário em HTML.\r\n\r\n- No caso de doações o valor do produto pode ser recebido através do formulário\r\n- Você também pode definir o valor através configurações \r\n\r\n### Formulário\r\n\r\n| Input | Descrição | Validação Obrigatória |\r\n| ------ | ------ | ------ |\r\n| edz-name |Nome e Sobrenome do cliente | ```\\w+\\s+\\w``` |\r\n| edz-email | E-mail do cliente | ```^[a-z0-9.]+@[a-z0-9]+\\.[a-z]+(\\.[a-z]+)?$``` |\r\n| edz-cellphone | Telefone do cliente |```^(?:(?:\\+\\|00)?(55)\\s?)?(?:\\(?([1-9][0-9])\\)?\\s?)?(?:((?:9\\d\\|[2-9])\\d{3})\\-?(\\d{4}))$``` | \r\n| edz-document | CPF do cliente | ```^([0-9]{3}\\.?[0-9]{3}\\.?[0-9]{3}\\-?[0-9]{2}\\|[0-9]{2}\\.?[0-9]{3}\\.?[0-9]{3}\\/?[0-9]{4}\\-?[0-9]{2})$``` |\r\n| edz-price | Valor de venda do Produto | ```^[1-9]\\d*(\\.\\d+)?$``` |\r\n\r\n### Exemplo de implementação\r\n\r\n```html\r\n\u003cform id=\"payment_form\"\u003e\r\n    \u003clabel for='edz-name'\u003eDigite seu nome\u003c/label\u003e\r\n    \u003cinput type='text' name='edz-name' id='edz-name'/\u003e\r\n\r\n    \u003clabel for='edz-email'\u003eDigite seu email\u003c/label\u003e\r\n    \u003cinput type='email' name='edz-email' id='edz-email'/\u003e\r\n\r\n    \u003clabel for='edz-cellphone'\u003eDigite seu telefone\u003c/label\u003e\r\n    \u003cinput type='tel' name='edz-cellphone' id='edz-cellphone'/\u003e\r\n\r\n    \u003clabel for='edz-document'\u003eDigite seu documento\u003c/label\u003e\r\n    \u003cinput type='text' name='edz-document' id='edz-document'/\u003e\r\n\r\n    \u003clabel for='edz-price'\u003eVALOR\u003c/label\u003e\r\n    \u003cinput type='text' name='edz-price' id='edz-price'/\u003e\r\n\r\n    \u003cbutton type='submit' name='btn_login'\u003ePAGAR\u003c/button\u003e\r\n\u003c/form\u003e\r\n\u003cscript type=\"text/javascript\"\u003e\r\n\r\n    var form = document.getElementById(\"payment_form\");\r\n\r\n    form.addEventListener(\"submit\", function(event) {\r\n        event.preventDefault();\r\n        pay(event);\r\n    });\r\n\r\n    function pay(event) {\r\n        var jsonFormData = eduzzPayment.formDataToJson(event.target);\r\n\r\n        eduzzPayment.setConfig({\r\n            returnUrl: 'https://meusite.com/retorno/minha-pagina-de-obrigado/',\r\n            postbackUrl: 'https://meusite.com/postback/',\r\n            queryParams: {\r\n                skip: 1\r\n            },\r\n            productId: 10000,\r\n            description: 'Valor Editável',\r\n            secret: '922ec9531b1f94add983a8ce2ebdc97b',\r\n        });\r\n    \r\n        const formData = {\r\n            name: jsonFormData.name,\r\n            email: jsonFormData.email,\r\n            document: jsonFormData.document,\r\n            cellphone: jsonFormData.cellphone,\r\n            price: jsonFormData.price,\r\n        }\r\n  \r\n        eduzzPayment.pay(formData);\r\n}\r\n\u003c/script\u003e\r\n```\r\n\r\n### Exemplo passando apenas o valor do produto\r\n\r\n```html\r\n\u003cform id=\"payment_form\"\u003e\r\n    \u003clabel for='edz-price'\u003eVALOR\u003c/label\u003e\r\n    \u003cinput type='text' name='edz-price' id='edz-price'/\u003e\r\n\r\n    \u003cbutton type='submit' name='btn_login'\u003ePAGAR\u003c/button\u003e\r\n\u003c/form\u003e\r\n\u003cscript type=\"text/javascript\"\u003e\r\n\r\n\r\n    var form = document.getElementById(\"payment_form\");\r\n\r\n    form.addEventListener(\"submit\", function(event) {\r\n        event.preventDefault();\r\n        pay(event);\r\n    });\r\n\r\n    function pay(event) {\r\n        var jsonFormData = eduzzPayment.formDataToJson(event.target);\r\n\r\n        eduzzPayment.setConfig({\r\n            returnUrl: 'https://meusite.com/retorno/minhapagina-de-obrigado/',\r\n            postbackUrl: 'https://meusite.com/postback/',\r\n            productId: 10000, \r\n            description: 'Valor Editável',\r\n            secret: '922ec9531b1f94add983a8ce2ebdc97b',\r\n        });\r\n\r\n        var formData = {\r\n            price: Number(jsonFormData.price),\r\n        }\r\n\r\n        eduzzPayment.pay(formData);\r\n    }\r\n\u003c/script\u003e\r\n```\r\n\r\n### Configuração de envio\r\n\r\nAo chamar a função `eduzzPayment.setConfig({ ... })` vocˆê dever'á passar os seguintes parâmetros preenchidos:\r\n\r\n| Configuração | Descrição |\r\n| ------ | ------ |\r\n| returnUrl | URL de Retorno, é o endereço que o usuário irá ao sair do Checkout |\r\n| postbackUrl | Informações sobre o pagamento serão enviadas para esta URL |\r\n| queryParams | Objecto JSON com as informações que irão ser passadas pela URL |\r\n| productId | ID do seu Produto na Eduzz |\r\n| description | Descrição da venda, o título que será exibido |\r\n| secret | Chave fornecida pela Eduzz para operar com o ecommerce |\r\n\r\n*Todas as informações podem ser fornecidas pelo suporte da Eduzz.*\r\n\r\n### API Function Calback\r\n\r\nAtravés de uma função JavaScript assinada para a `eduzzPayment.pay(event, ErrorHandlerCallbackFunction)` você pode tratar as respostas retornadas pela API de Pagamentos da Eduzz.\r\n```html\r\n...\r\n\u003cform onsubmit=\"eduzzPayment.pay(event, ErrorHandlerCallbackFunction)\"\u003e\r\n ...\r\n \r\n\u003cscript type=\"text/javascript\"\u003e\r\n    ErrorHandlerCallbackFunction(returnedData) {\r\n        // Fazer alguma ação com o retorno \r\n    }\r\n\u003c/script\u003e\r\n...\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feduzz%2Fecommerce-integration-form","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feduzz%2Fecommerce-integration-form","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feduzz%2Fecommerce-integration-form/lists"}