{"id":2088,"date":"2021-04-20T08:52:23","date_gmt":"2021-04-20T11:52:23","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?p=2088"},"modified":"2023-03-24T17:40:54","modified_gmt":"2023-03-24T20:40:54","slug":"criando-uma-cobranca-via-pix","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2021\/04\/criando-uma-cobranca-via-pix\/","title":{"rendered":"Criando uma cobran\u00e7a via PIX"},"content":{"rendered":"\n<p>Ap\u00f3s inicializar a comunica\u00e7\u00e3o com o PIX, de acordo com o padr\u00e3o de cada banco\/fornecedor voc\u00ea deve montar um mapa com os dados da cobran\u00e7a.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CHAVE <\/strong>(Letras) &#8211; Chave PIX de quem ir\u00e1 receber o dinheiro, ser\u00e1 fornecida pelo banco (Chave DICT do recebedor). No ambiente de homologa\u00e7\u00e3o informe uma das chaves de testes <span class=\"has-inline-color has-vivid-red-color\">[Obrigat\u00f3rio]<\/span>;<\/li>\n\n\n\n<li><strong>TRANSACAO_ID <\/strong>(Letras) &#8211; Identificador \u00fanico da transa\u00e7\u00e3o (tx_id) conte\u00fado letras e n\u00fameros com at\u00e9 35 caracteres <span class=\"has-inline-color has-vivid-red-color\">[Obrigat\u00f3rio]<\/span>;<\/li>\n\n\n\n<li><strong>DEVEDOR_NOME <\/strong>(Letras) &#8211; Nome da pessoa que est\u00e1 sendo cobrada\/solicitada <span class=\"has-inline-color has-vivid-red-color\">[Obrigat\u00f3rio]<\/span>;<\/li>\n\n\n\n<li><strong>DEVEDOR_CPF <\/strong>(Letras) &#8211; N\u00famero do CPF do devedor quando for pessoa fisica <span class=\"has-inline-color has-vivid-red-color\">[Obrigat\u00f3rio se for PF]<\/span>;<\/li>\n\n\n\n<li><strong>DEVEDOR_CNPJ <\/strong>(Letras) &#8211; N\u00famero do CNPJ do devedor quando for pessoa jur\u00eddica <span class=\"has-inline-color has-vivid-red-color\">[Obrigat\u00f3rio se for PJ]<\/span>;<\/li>\n\n\n\n<li><strong>VALOR_ORIGINAL <\/strong>(Fracionado) &#8211; Valor em reais (R$), com at\u00e9 02 (dois) digitos<span class=\"has-inline-color has-vivid-red-color\"> [Obrigat\u00f3rio]<\/span>;<\/li>\n\n\n\n<li><strong>SOLICITACAO_PAGADOR<\/strong> (Letras) &#8211; Texto que ser\u00e1 apresentado ao pagador;<\/li>\n\n\n\n<li><strong>INFO_ADICIONAIS<\/strong> (Variante) &#8211; Mapa com nome\/valor em Letras de informa\u00e7\u00f5es adicionais da cobran\u00e7a;<\/li>\n\n\n\n<li><strong>CALENDARIO_EXPIRACAO_SEGUNDOS<\/strong> (Inteiro) &#8211; Por quanto tempo a cobran\u00e7a ficar\u00e1 dispon\u00edvel para pagamento (EX: 3600 para 60 minutos), usado quando a cobran\u00e7a \u00e9 instant\u00e2nea;<\/li>\n\n\n\n<li><strong>CALENDARIO_DH_EXPIRACAO<\/strong> (Data) &#8211; Substitui a informa\u00e7\u00e3o dos segundos por uma data e hora espec\u00edfica. O tempo ser\u00e1 calculado baseado na hora atual do servidor onde a API esta sendo executada. Isso pode gerar diferen\u00e7as em rela\u00e7\u00e3o ao servidor do banco, em especial diferen\u00e7a por configura\u00e7\u00e3o de fuso hor\u00e1rios, ou mera diferen\u00e7a de hor\u00e1rio entre os servidores. Quando informar esse campo <strong>n\u00e3o deve<\/strong> ser informado o campo &#8220;<strong>CALENDARIO_EXPIRACAO_SEGUNDOS<\/strong>&#8220;.<\/li>\n\n\n\n<li> (Dispon\u00edvel a partir da vers\u00e3o publicada ap\u00f3s 19\/05\/2022.)<\/li>\n<\/ul>\n\n\n\n<p>Ap\u00f3s montar o mapa com os dados da cobran\u00e7a voc\u00ea pode chamar a fun\u00e7\u00e3o &#8220;<strong>PIX &#8211; Criar Cobran\u00e7a<\/strong>&#8221; passando os seguintes par\u00e2metros:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Conex\u00e3o (Retorno da fun\u00e7\u00e3o &#8220;<strong>PIX &#8211; Inicializar<\/strong>&#8220;);<\/li>\n\n\n\n<li>ID da transa\u00e7\u00e3o (Letras) &#8211; Deixe em branco para gerar um novo autom\u00e1ticamente;<\/li>\n\n\n\n<li>Dados da cobran\u00e7a (Variante) &#8211; Mapa com os dados descritos acima. Opcionalmente voc\u00ea pode passar o JSON (Letras) j\u00e1 pronto, seguindo o padr\u00e3o do PIX definido pelo BCB;<\/li>\n<\/ol>\n\n\n\n<p>O retorno da fun\u00e7\u00e3o ser\u00e1 um Variante com um Mapa com os dados do PIX gerado. Este mapa poder\u00e1 conter al\u00e9m dos itens descritos no envio tamb\u00e9m os seguintes itens:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>SUCESSO<\/strong> (L\u00f3gico) &#8211; Indica se a opera\u00e7\u00e3o foi conclu\u00edda com sucesso;<\/li>\n\n\n\n<li><strong>QRCODE_TEXTO <\/strong>&#8211; Texto do QrCode para pagamento;<\/li>\n\n\n\n<li><strong>REVISAO_NUMERO <\/strong>&#8211; N\u00famero da revis\u00e3o da cobran\u00e7a;<\/li>\n\n\n\n<li><strong>SITUACAO <\/strong>(Letras) &#8211; Texto indicando a situa\u00e7\u00e3o da cobran\u00e7a:\n<ul class=\"wp-block-list\">\n<li><strong>ATIVA <\/strong>&#8211; a cobran\u00e7a est\u00e1 dispon\u00edvel, por\u00e9m ainda n\u00e3o ocorreu pagamento;<\/li>\n\n\n\n<li><strong>CONCLUIDA <\/strong>&#8211; a cobran\u00e7a encontra-se paga. N\u00e3o se pode alterar e nem remover uma cobran\u00e7a cujo status esteja \u201cCONCLU\u00cdDA\u201d;<\/li>\n\n\n\n<li>EM_PROCESSAMENTO &#8211; liquida\u00e7\u00e3o em processamento;<\/li>\n\n\n\n<li><strong>NAO_REALIZADO <\/strong>&#8211; indica que a devolu\u00e7\u00e3o n\u00e3o pode ser realizada em fun\u00e7\u00e3o de algum erro durante a liquida\u00e7\u00e3o, como por exemplo, saldo insuficiente.;<\/li>\n\n\n\n<li><strong>DEVOLVIDO <\/strong>&#8211; cobran\u00e7a com devolu\u00e7\u00e3o realizada pelo Sistema de Pagamentos Instant\u00e2neos (SPI);<\/li>\n\n\n\n<li><strong>REMOVIDA_PELO_USUARIO_RECEBEDOR <\/strong>&#8211; foi solicitada a remo\u00e7\u00e3o da cobran\u00e7a; a crit\u00e9rio do usu\u00e1rio;<\/li>\n\n\n\n<li><strong>REMOVIDA_PELO_PSP <\/strong>&#8211; recebedor, por conta de algum crit\u00e9rio, solicitou a remo\u00e7\u00e3o da cobran\u00e7a.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>DEVOLUCOES_VALOR <\/strong>(Fracionado) &#8211; Valor total das devolu\u00e7\u00f5es se houver;<\/li>\n\n\n\n<li><strong>ERRO_DESCRICAO <\/strong>(Letras) &#8211; Texto descritivo do erro (se houve falha);<\/li>\n\n\n\n<li><strong><span class=\"has-inline-color has-vivid-red-color\">_RESPOSTA<\/span><\/strong> (Letras) &#8211; Texto integral retornado pelo servidor do banco;<\/li>\n\n\n\n<li><strong><span class=\"has-inline-color has-vivid-red-color\">_HTTP_STATUS_MESSAGE<\/span> <\/strong>(Letras) &#8211; Texto descritivo da situa\u00e7\u00e3o da comunica\u00e7\u00e3o HTTPS;<\/li>\n\n\n\n<li><strong><span class=\"has-inline-color has-vivid-red-color\">_HTTP_STATUS_CODE<\/span> <\/strong>&#8211; C\u00f3digo HTTP da resposta do servidor do PSP. Zero indica que n\u00e3o houve comunica\u00e7\u00e3o (causada por um firewall ou falha da Internet por exemplo).<\/li>\n<\/ul>\n\n\n\n<p>O preenchimento dos dados acima ir\u00e1 depender da situa\u00e7\u00e3o e hist\u00f3rico da cobran\u00e7a.<\/p>\n\n\n\n<p>Utilize esse retorno para gerar a imagem do QRCode atrav\u00e9s da fun\u00e7\u00e3o &#8220;<strong>PIX &#8211; Gerar QrCode<\/strong>&#8220;, para obter o QR Code em texto obtenha o elemento &#8220;QRCODE_TEXTO&#8221; no mapa retornado pela fun\u00e7\u00e3o &#8220;<strong>PIX &#8211; Criar Cobran\u00e7a<\/strong>&#8220;.<\/p>\n\n\n\n<p>Salve o JSON original retornado pela servidor obtendo o item &#8220;<strong>_RETORNO<\/strong>&#8221; do mapa retornado pela fun\u00e7\u00e3o &#8220;<strong>PIX &#8211; Criar Cobran\u00e7a<\/strong>&#8220;, bem como o item &#8220;<strong>TRANSACAO_ID<\/strong>&#8221; para posterior consulta da situa\u00e7\u00e3o do PIX.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Ap\u00f3s inicializar a comunica\u00e7\u00e3o com o PIX, de acordo com o padr\u00e3o de cada banco\/fornecedor voc\u00ea deve montar um mapa com os dados da cobran\u00e7a. Ap\u00f3s montar o mapa com os dados da cobran\u00e7a voc\u00ea pode chamar a fun\u00e7\u00e3o &#8220;PIX &#8211; Criar Cobran\u00e7a&#8221; passando os seguintes par\u00e2metros: O retorno da fun\u00e7\u00e3o ser\u00e1 um Variante com [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[246],"tags":[14,248,249,16,247,17],"class_list":["post-2088","post","type-post","status-publish","format-standard","hentry","category-api-pix-maker-documentacao","tag-api","tag-bcb","tag-cobranca","tag-maker","tag-pix","tag-webrun"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/2088","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/comments?post=2088"}],"version-history":[{"count":10,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/2088\/revisions"}],"predecessor-version":[{"id":2800,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/2088\/revisions\/2800"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=2088"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=2088"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=2088"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}