{"id":23579710,"url":"https://github.com/eduzz/postback","last_synced_at":"2026-01-29T05:47:51.075Z","repository":{"id":269232308,"uuid":"848471438","full_name":"eduzz/postback","owner":"eduzz","description":"Receba postback com as informações de cada transação na Eduzz","archived":false,"fork":false,"pushed_at":"2024-08-27T20:28:37.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-13T03:01:52.338Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"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":null,"code_of_conduct":null,"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":"2024-08-27T20:26:06.000Z","updated_at":"2024-08-27T20:28:40.000Z","dependencies_parsed_at":"2024-12-22T01:04:53.652Z","dependency_job_id":"e47775c0-c590-48c9-ad87-318681853601","html_url":"https://github.com/eduzz/postback","commit_stats":null,"previous_names":["eduzz/postback"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduzz%2Fpostback","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduzz%2Fpostback/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduzz%2Fpostback/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eduzz%2Fpostback/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eduzz","download_url":"https://codeload.github.com/eduzz/postback/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254582909,"owners_count":22095519,"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-12-26T23:12:05.497Z","updated_at":"2026-01-29T05:47:51.041Z","avatar_url":"https://github.com/eduzz.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Postback Eduzz\n\n## Sobre o postback\n\nO recurso de postback permite que você receba notificações de alguns eventos que ocorrem dentro do sistema, possibilitando que alem do produtor, o afiliado tambem tenha um melhor controle sobre seu negócio.\n\nNo momento estão disponíveis apenas as ações referentes ao **rastreamento** de campanhas:\n\n- TRACKER.CHECKOUT - Acionado ao carregamento de um carrinho\n- TRACKER.THANKYOU - Acionado quando o cliente chega até a página de obrigado\n- TRACKER.BOLETO - Acionado sempre que um boleto é visualizado\n\nAs informações de alteração de status de compra estão disponíveis apenas para os produtores através do webhook. Muito em breve essas notificações estarão unificadas via postback tambem para os afiliados\n\n---\n\n## Cadastro de URL\n\n1. Logue em sua conta e acesse o menu `Afiliado \u003e\u003e Meus Funis / Campanhas`\n2. Na listagem de suas campanhas, clique no ícone conforme indicado na imagem abaixo: \n![alt tag](postback1.jpg)\n\n3. Na tela seguinte, cadastre a URL onde você deseja receber as notificações do sistema\n![alt tag](postback2.jpg)\n\n---\n\n## Requisições válidas e retentativas\n\nNo caso de falha, são realizados 5 tentativas no intervalo de 12 horas ( 2m,6m,24m,2h,12h), após esse periodo sem sucesso, a postback é cancelado. Consideramos válidas todas as requisicoes que retornam o status HTTP 200.\n\n---\n\n## Validação\n\nEnviamos via `header` o parametro `X-EduzzApi` , que deve ser comparada com a Chave de API do Afiliado/Produtor que receberá o postback.\n\n---\n\n## Parametros enviados\n\n| Parâmetro               | Descrição                                                                                                                                              |\n| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `event.action`          | Ação de evento ( `TRACKER.CHECKOUT, TRACKER.BOLETO, TRACKER.THANKYOU` )                                                                                |\n| `event.datetime`        | Data e hora do evento no formato YYYY-MM-DD HH:MM:SS ex: 2016-10-26 22:02:25                                                                           |\n| `invoice.id`            | ID da fatura se houver.                                                                                                                                |\n| `invoice.value`         | Valor da fatura se houver                                                                                                                              |\n| `invoice.status`        | Status da fatura ( Ver [Tabela de status de pagamento](#tabela-de-status-da-fatura) )                                                                  |\n| `invoice.paymentmethod` | Forma de pagamento ( Ver [Tabela de formas de pagamento](#tabela-de-formas-de-pagamento) )                                                             |\n| `invoice.datetime`      | Data de criação da fatura ( Clicou em pagar ) no formato YYYY-MM-DD HH:MM:SS ex: 2016-10-26 22:02:25                                                   |\n| `invoice.paymentdate`   | Data de pagamento se houver no formato YYYY-MM-DD HH:MM:SS ex: 2016-10-26                                                                              |\n| `product.id`            | Código do conteudo                                                                                                                                     |\n| `product.name`          | Nome do conteudo                                                                                                                                       |\n| `customer.id`           | ID do cliente se houver                                                                                                                                |\n| `customer.name`         | Nome do cliente se houver                                                                                                                              |\n| `customer.email`        | Email do cliente se houver                                                                                                                             |\n| `partner.id`            | ID do afiliado se houver                                                                                                                               |\n| `partner.name`          | Nome do afiliado se houver                                                                                                                             |\n| `partner.email`         | E-mail do afiliado se houver                                                                                                                           |\n| `tracker.funnelkey`     | Código da campanha se houver                                                                                                                           |\n| `tracker.utm_source`    | Referencia informada na momento do clique (Ex: [http://edz.la/XXXX?a=815959\u0026utm_source=BANNER01](http://edz.la/XXXX?a=815959\u0026utm_source=BANNER01))     |\n| `tracker.utm_content`   | Referencia informada no momento do clique (Ex: [http://edz.la/XXXX?a=815959\u0026utm_content=BANNER02](http://edz.la/XXXX?a=815959\u0026utm_content=BANNER02))   |\n| `tracker.utm_campaign`  | Referencia informada no momento do clique (Ex: [http://edz.la/XXXX?a=815959\u0026utm_campaign=BANNER03](http://edz.la/XXXX?a=815959\u0026utm_campaign=BANNER03)) |\n| `tracker.utm_medium`    | Referencia informada no momento do clique (Ex: [http://edz.la/XXXX?a=815959\u0026utm_medium=BANNER01](http://edz.la/XXXX?a=815959\u0026utm_medium=BANNER01))     |\n| `tracker.ip`            | IP de origem da transação                                                                                                                              |\n| `cart.key`              | Código da pagina de checkout                                                                                                                           |\n| `cart.datetime`         | Data de primeira abertura do checkout no formato YYYY-MM-DD HH:MM:SS ex: 2016-10-26 22:02:25                                                           |\n\n### Tabela de status da fatura\n\n| ID   | Status               | Descrição                                                                             |\n| ---- | -------------------- | ------------------------------------------------------------------------------------- |\n| `1`  | Aberto               | Fatura foi gerada ( Clicou em pagar e não foi autorizado, ou apenas gerou um boleto ) |\n| `3`  | Paga                 | Compra foi paga, o cliente já esta apto a receber o produto                           |\n| `4`  | Cancelada            | Fatura Cancelada pela Eduzz                                                           |\n| `6`  | Aguardando Reembolso | Cliente solicitou reembolso, porem o mesmo ainda não foi efetuado                     |\n| `7`  | Reembolsado          | Cliente já foi reembolsado pela eduzz                                                 |\n| `8`  | Em Análise           | Cliente efetuou o pagamento, porém esta em análise pela instituição financeira        |\n| `11` | Em Recuperacao       | Fatura entrou para o processo de recuperação                                          |\n\n### Tabela de formas de pagamento\n\n| ID   | Forma de pagamento     |\n| ---- | ---------------------- |\n| `1`  | Boleto Bancário        |\n| `9`  | Paypal                 |\n| `13` | Visa                   |\n| `15` | Mastercard             |\n| `16` | Diners                 |\n| `17` | Débito Banco do Brasil |\n| `18` | Débito Bradesco        |\n| `19` | Débito Itaú            |\n| `21` | Hipercard              |\n| `22` | Débito Banrisul        |\n| `23` | Hiper                  |\n| `24` | Elo                    |\n| `25` | Paypal Internacional   |\n\n---\n\n# Exemplos\n\n### RAW BODY\n\n`cart.datetime=2016-10-26+23%3A11%3A14\u0026cart.key=000000-WJWUPJ-ZFZVIP-GBN9Y7\u0026event.action=TRACKER.CHECKOUT\u0026event.datetime=2016-10-26+23%3A12%3A01\u0026request.datetime=2016-10-26+23%3A12%3A42\u0026request.id=EDZ45PB\u0026request.queue=b12962c493c3cafe6db4039515a6c0c7\u0026request.tries=1\u0026request.type=TRACKER.CHECKOUT\u0026tracker.funnelkey=KKAAM\u0026tracker.ip=177.43.204.90\u0026tracker.utm_campaign=TESTE_TRACKER2\u0026tracker.utm_content=\u0026tracker.utm_medium=TESTE_TRACKER2\u0026tracker.utm_source=TESTE_TRACKER`\n\n### Suporte\n\nEncontrou algum problema? Entre em contato com nosso [suporte](mailto://eduzz.com) e nós ficaremos felizes em ajuda-lo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feduzz%2Fpostback","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feduzz%2Fpostback","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feduzz%2Fpostback/lists"}