{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Introdução","type":"basic","slug":"exemplos-de-integracao","excerpt":"Exemplos funcionais de todos os serviços de cobranças oferecidos na API Gerencianet","body":"Buscando oferecer uma forma de clientes e integradores visualizar na prática como são emitidas nossas cobranças, oferecemos vários **exemplos prontos de integração com as APIs da Gerencianet** que demonstram a modalidade de **boleto/Bolix**, **carnê**, **cartão de crédito**, **Pix**, **assinaturas (cobrança recorrente)**, **link de pagamento** e **marketplace (split de pagamento)**, podendo assim ter uma experiência com os nossos serviços antes de ir para o desenvolvimento.\n[block:html]\n{\n  \"html\": \"<a href=\\\"https://www.gerencianet.com.br/wp-content/themes/Gerencianet/exemplos-api/\\\" target=\\\"_blank\\\" alt=\\\"ACESSAR EXEMPLOS DE DEMONSTRAÇÃO\\\"><button type=\\\"button\\\" class=\\\"buttonCTA buttonorange\\\">ACESSAR EXEMPLOS DE DEMONSTRAÇÃO</button></a>\"\n}\n[/block]\n<a href=\"https://www.gerencianet.com.br/wp-content/themes/Gerencianet/exemplos-api/\" target=\"_blank\"><img align=\"center\" src=\"https://s3.amazonaws.com/gerencianet-pub-prod-1/printscreen/2021/09/24/guilherme.cota/595349-d4f64234-3099-417c-8ec2-2e3aedd1d8f6.gif\"> \n</a>\n\nAlém da possibilidade de executar estes testes, deixamos todos os códigos utilizados nestes exemplos disponíveis para download. Vale ressaltar que, nestes exemplos foi utilizado a <a https://dash.readme.com/legacy/href=\"https://dev.gerencianet.com.br/docs/instalacao-sdk-php\" target=\"_blank\" alt=\"SDK de PHP Gerencianet\">SDK de PHP</a> para integração com as APIs.\n\n## Executar exemplos\n\nPara executar estes exemplos em seu ambiente você precisa <a href=\"https://gerencianet.com.br/#abrirconta\" target=\"_blank\">criar uma conta Gerencianet</a> e <a href=\"https://s3.amazonaws.com/gerencianet-pub-prod-1/printscreen/2021/04/14/macario.junior/1-create-app-pangeia.png\" target=\"_blank\">criar uma aplicação</a> para obter as credenciais.\n[block:html]\n{\n  \"html\": \"<a href=\\\"https://www.gerencianet.com.br/wp-content/themes/Gerencianet/exemplos-api/download/exemplos-integracao.zip\\\" alt=\\\"BAIXAR CÓDIGOS DE EXEMPLOS DE INTEGRAÇÃO\\\"><button type=\\\"button\\\" class=\\\"buttonCTA buttonorange\\\">BAIXAR CÓDIGOS DE EXEMPLOS DE INTEGRAÇÃO</button></a>\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Após baixar estes exemplos, não esqueça de inserir suas credenciais no arquivo **credentials.json**, sendo elas, o <code>Client_Id</code> e <code>Client_Secret</code> de acordo com o ambiente utilizado (Homologação ou produção), além de lembrar que o parâmetro <code>sandbox</code> é booleana e possui 2 valores possíveis, de acordo com o ambiente, sendo: <code>sandbox => true</code> equivale ao ambiente de Homologação e <code>sandbox => false</code> equivale ao ambiente de produção. \\n\\nPara utilizar o exemplo do *Pix*, deve-se informar também no arquivo **credentials.json**, no atributo <code>pix_cert</code> o diretório **./certs/**, acrescentando o nome do seu certificado no formato **.pem**. Aqui você encontra dicas para <a href=\\\"https://dev.gerencianet.com.br/docs/api-pix-autenticacao-e-seguranca#section-gerando-um-certificado-p12\\\" target=\\\"_blank\\\">gerar seu certificado e convertê-lo **.p12** para **.pem**</a>. É necessário também, no arquivo **./pix/emitir_pix.php**, na variável <code>$body</code> insira sua <a href=\\\"https://gerencianet.com.br/artigo/como-cadastrar-chaves-pix/\\\"  target=\\\"_blank\\\">chave pix registrada na Gerencianet</a> no parâmetro <code>\\\"chave\\\" => \\\"\\\"</code>.\\n\\nPara funcionamento dos exemplos que envolvem a emissão de *cartão de crédito*, é necessário que você informe seu **Identificador de Conta** <a href=\\\"https://cdn.discordapp.com/attachments/652136190006525955/809138574549188618/identificador-conta.jpg\\\" target=\\\"_blank\\\">(?)</a> na **linha 1** do script contido no arquivo **./assets/js/payment-token.js**. Script este que é utilizado para obtenção do *payment_token*. Importante frisar que este código é específico de acordo com o ambiente utilizado (produção ou Homologação). <a href=\\\"https://dev.gerencianet.com.br/docs/pagamento-com-cartao#section-1-1-obten-o-do-payment_token\\\" target=\\\"_blank\\\">Veja neste link</a> como obter corretamente seu payment_token.\",\n  \"title\": \"IMPORTANTE\"\n}\n[/block]\nPor se tratar de um exemplo meramente ilustrativo e de cunho educativo, é necessário que você adapte à sua necessidade. **Não nos responsabilizamos pela utilização deste exemplo sem os ajustes necessários para seu ambiente de produção.**","updates":[],"order":6,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"614c6d3e0a50c701f8086aea","createdAt":"2021-09-23T12:04:14.791Z","user":"602e5e09fc538d0018a4003f","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Exemplos de Integrações","slug":"exemplos-de-integrações","order":19,"from_sync":false,"reference":false,"_id":"606f2ca6c5ba91007878342d","version":"606f2ca7c5ba9100787834c6","__v":0,"createdAt":"2016-06-14T16:25:26.623Z","project":"575aeffae12cf20e002f306c"},"version":{"version":"1.1.0","version_clean":"1.1.0","codename":"2021","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["606f2ca6c5ba91007878342b","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","606f2ca6c5ba91007878342c","606f2ca6c5ba91007878342d","606f2ca6c5ba91007878342e","606f2ca6c5ba91007878342f","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","606f2ca6c5ba910078783430","606f2ca6c5ba910078783431","5783f78c5cbce30e0074e2b7","606f2ca6c5ba910078783432","606f2ca6c5ba910078783433","606f2ca6c5ba910078783434","606f2ca6c5ba910078783435","606f2ca6c5ba910078783436","606f2ca6c5ba910078783437","578529f887c9280e0090394b","606f2ca6c5ba910078783438","606f2ca6c5ba910078783439","606f2ca6c5ba91007878343a","606f2ca6c5ba91007878343b","606f2ca6c5ba91007878343c","606f2ca6c5ba91007878343d","606f2ca6c5ba91007878343e","606f2ca6c5ba91007878343f","606f2ca6c5ba910078783440","606f2ca6c5ba910078783441","60d61f026ddc3901a32ee5f1","60ec37c637005f015e54174e","61473375119247002a9c14d7"],"_id":"606f2ca7c5ba9100787834c6","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","__v":3,"forked_from":"575aeffae12cf20e002f306f"},"project":"575aeffae12cf20e002f306c","__v":0,"parentDoc":null}

Introdução

Exemplos funcionais de todos os serviços de cobranças oferecidos na API Gerencianet

Buscando oferecer uma forma de clientes e integradores visualizar na prática como são emitidas nossas cobranças, oferecemos vários **exemplos prontos de integração com as APIs da Gerencianet** que demonstram a modalidade de **boleto/Bolix**, **carnê**, **cartão de crédito**, **Pix**, **assinaturas (cobrança recorrente)**, **link de pagamento** e **marketplace (split de pagamento)**, podendo assim ter uma experiência com os nossos serviços antes de ir para o desenvolvimento. [block:html] { "html": "<a href=\"https://www.gerencianet.com.br/wp-content/themes/Gerencianet/exemplos-api/\" target=\"_blank\" alt=\"ACESSAR EXEMPLOS DE DEMONSTRAÇÃO\"><button type=\"button\" class=\"buttonCTA buttonorange\">ACESSAR EXEMPLOS DE DEMONSTRAÇÃO</button></a>" } [/block] <a href="https://www.gerencianet.com.br/wp-content/themes/Gerencianet/exemplos-api/" target="_blank"><img align="center" src="https://s3.amazonaws.com/gerencianet-pub-prod-1/printscreen/2021/09/24/guilherme.cota/595349-d4f64234-3099-417c-8ec2-2e3aedd1d8f6.gif"> </a> Além da possibilidade de executar estes testes, deixamos todos os códigos utilizados nestes exemplos disponíveis para download. Vale ressaltar que, nestes exemplos foi utilizado a <a https://dash.readme.com/legacy/href="https://dev.gerencianet.com.br/docs/instalacao-sdk-php" target="_blank" alt="SDK de PHP Gerencianet">SDK de PHP</a> para integração com as APIs. ## Executar exemplos Para executar estes exemplos em seu ambiente você precisa <a href="https://gerencianet.com.br/#abrirconta" target="_blank">criar uma conta Gerencianet</a> e <a href="https://s3.amazonaws.com/gerencianet-pub-prod-1/printscreen/2021/04/14/macario.junior/1-create-app-pangeia.png" target="_blank">criar uma aplicação</a> para obter as credenciais. [block:html] { "html": "<a href=\"https://www.gerencianet.com.br/wp-content/themes/Gerencianet/exemplos-api/download/exemplos-integracao.zip\" alt=\"BAIXAR CÓDIGOS DE EXEMPLOS DE INTEGRAÇÃO\"><button type=\"button\" class=\"buttonCTA buttonorange\">BAIXAR CÓDIGOS DE EXEMPLOS DE INTEGRAÇÃO</button></a>" } [/block] [block:callout] { "type": "warning", "body": "Após baixar estes exemplos, não esqueça de inserir suas credenciais no arquivo **credentials.json**, sendo elas, o <code>Client_Id</code> e <code>Client_Secret</code> de acordo com o ambiente utilizado (Homologação ou produção), além de lembrar que o parâmetro <code>sandbox</code> é booleana e possui 2 valores possíveis, de acordo com o ambiente, sendo: <code>sandbox => true</code> equivale ao ambiente de Homologação e <code>sandbox => false</code> equivale ao ambiente de produção. \n\nPara utilizar o exemplo do *Pix*, deve-se informar também no arquivo **credentials.json**, no atributo <code>pix_cert</code> o diretório **./certs/**, acrescentando o nome do seu certificado no formato **.pem**. Aqui você encontra dicas para <a href=\"https://dev.gerencianet.com.br/docs/api-pix-autenticacao-e-seguranca#section-gerando-um-certificado-p12\" target=\"_blank\">gerar seu certificado e convertê-lo **.p12** para **.pem**</a>. É necessário também, no arquivo **./pix/emitir_pix.php**, na variável <code>$body</code> insira sua <a href=\"https://gerencianet.com.br/artigo/como-cadastrar-chaves-pix/\" target=\"_blank\">chave pix registrada na Gerencianet</a> no parâmetro <code>\"chave\" => \"\"</code>.\n\nPara funcionamento dos exemplos que envolvem a emissão de *cartão de crédito*, é necessário que você informe seu **Identificador de Conta** <a href=\"https://cdn.discordapp.com/attachments/652136190006525955/809138574549188618/identificador-conta.jpg\" target=\"_blank\">(?)</a> na **linha 1** do script contido no arquivo **./assets/js/payment-token.js**. Script este que é utilizado para obtenção do *payment_token*. Importante frisar que este código é específico de acordo com o ambiente utilizado (produção ou Homologação). <a href=\"https://dev.gerencianet.com.br/docs/pagamento-com-cartao#section-1-1-obten-o-do-payment_token\" target=\"_blank\">Veja neste link</a> como obter corretamente seu payment_token.", "title": "IMPORTANTE" } [/block] Por se tratar de um exemplo meramente ilustrativo e de cunho educativo, é necessário que você adapte à sua necessidade. **Não nos responsabilizamos pela utilização deste exemplo sem os ajustes necessários para seu ambiente de produção.**