<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: David William Balbino</title>
    <description>The latest articles on DEV Community by David William Balbino (@david_williambalbino_7ec).</description>
    <link>https://dev.to/david_williambalbino_7ec</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4247981%2Fbb2ef515-fad2-41cf-8dee-8017098add19.png</url>
      <title>DEV Community: David William Balbino</title>
      <link>https://dev.to/david_williambalbino_7ec</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/david_williambalbino_7ec"/>
    <language>en</language>
    <item>
      <title>Pix em Laravel com a API da PushinPay: client HTTP, webhook com HMAC e job idempotente</title>
      <dc:creator>David William Balbino</dc:creator>
      <pubDate>Mon, 16 Nov 2026 16:25:53 +0000</pubDate>
      <link>https://dev.to/david_williambalbino_7ec/pix-em-laravel-com-a-api-da-pushinpay-client-http-webhook-com-hmac-e-job-idempotente-26hc</link>
      <guid>https://dev.to/david_williambalbino_7ec/pix-em-laravel-com-a-api-da-pushinpay-client-http-webhook-com-hmac-e-job-idempotente-26hc</guid>
      <description>&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fm7ok5o26f3kjeorzwxvo.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fm7ok5o26f3kjeorzwxvo.png" alt="Pix em Laravel com a API da PushinPay: client HTTP, webhook com HMAC e job idempotente" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;O jeito que eu estruturo uma integração Pix em Laravel: testo tudo no sandbox antes e trato o webhook repetido sem marcar o pedido como pago duas vezes.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Eu sou o David, cofundador e diretor de produtos da PushinPay. Quando um dev me pergunta como organizar o Pix num projeto Laravel, eu costumo dar a mesma resposta. Uma classe pequena fala com a API. Um controller de webhook só valida e põe na fila. E um job consulta a transação antes de mexer no pedido. Aqui está esse roteiro, com o código e os erros que eu mais vejo nas integrações.&lt;/p&gt;

&lt;h2&gt;
  
  
  Antes do PHP: token, hosts e um curl
&lt;/h2&gt;

&lt;p&gt;O token é gerado no painel da PushinPay e vai em toda requisição, com estes headers:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;code&gt;Authorization: Bearer SEU_TOKEN&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Accept: application/json&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;São dois ambientes:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Sandbox:&lt;/strong&gt; &lt;code&gt;api-sandbox.pushinpay.com.br&lt;/code&gt;, para homologação e testes de integração.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Produção:&lt;/strong&gt; &lt;code&gt;api.pushinpay.com.br&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Se a sua aplicação só recebe Pix, um token comum resolve. Para fazer saque (Pix out), o token precisa ter permissão de transferência. Na conta também dá para ativar token 2FA e controle por IP.&lt;/p&gt;

&lt;p&gt;Antes de abrir o editor, eu crio uma cobrança no sandbox direto pelo terminal. Se der erro aqui, o problema está no token ou no payload, não no seu código:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl -X POST https://api-sandbox.pushinpay.com.br/api/pix/cashIn \
  -H &lt;span class="s2"&gt;"Authorization: Bearer SEU_TOKEN"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Accept: application/json"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; \
  -d &lt;span class="s1"&gt;'{
    "value": 1990,
    "expires_in": 3600,
    "description": "Pedido 1042",
    "webhook_url": "https://sua-app.com.br/api/webhooks/pushinpay"
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;O que cada campo aceita:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;value&lt;/code&gt;: em &lt;strong&gt;centavos&lt;/strong&gt;. 1990 = R$ 19,90. O mínimo é 50 (R$ 0,50).&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;expires_in&lt;/code&gt;: em segundos, de 300 a 172800 (5 minutos a 48 horas).&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;description&lt;/code&gt;: até 255 caracteres.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;webhook_url&lt;/code&gt;: opcional por cobrança. Também dá para configurar uma URL por conta.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Na resposta vêm &lt;code&gt;id&lt;/code&gt;, &lt;code&gt;qr_code&lt;/code&gt; (o Pix copia e cola), &lt;code&gt;qr_code_base64&lt;/code&gt; (a imagem do QR), &lt;code&gt;status&lt;/code&gt; e &lt;code&gt;value&lt;/code&gt;. Depois do pagamento a transação passa a ter também &lt;code&gt;end_to_end_id&lt;/code&gt;, &lt;code&gt;payer_name&lt;/code&gt; e &lt;code&gt;payer_national_registration&lt;/code&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Configuração no Laravel
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;.env&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nv"&gt;PUSHINPAY_BASE_URL&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;https://api-sandbox.pushinpay.com.br
&lt;span class="nv"&gt;PUSHINPAY_TOKEN&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;SEU_TOKEN
&lt;span class="nv"&gt;PUSHINPAY_WEBHOOK_SECRET&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;SEU_SEGREDO
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;config/services.php&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="s1"&gt;'pushinpay'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="s1"&gt;'base_url'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;env&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'PUSHINPAY_BASE_URL'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s1"&gt;'token'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;env&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'PUSHINPAY_TOKEN'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s1"&gt;'webhook_secret'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;env&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'PUSHINPAY_WEBHOOK_SECRET'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Na hora de ir para produção, você troca a &lt;code&gt;PUSHINPAY_BASE_URL&lt;/code&gt; e o token. O código continua igual.&lt;/p&gt;

&lt;h2&gt;
  
  
  O client
&lt;/h2&gt;

&lt;p&gt;Uma classe só para a API, usando o client HTTP do próprio Laravel. Ela fica fácil de mockar nos testes, e o resto da aplicação não precisa saber de URL nem de header.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="o"&gt;&amp;lt;?&lt;/span&gt;&lt;span class="n"&gt;php&lt;/span&gt;

&lt;span class="k"&gt;namespace&lt;/span&gt; &lt;span class="nc"&gt;App&lt;/span&gt;\&lt;span class="nc"&gt;Services&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Http&lt;/span&gt;\&lt;span class="nc"&gt;Client&lt;/span&gt;\&lt;span class="nc"&gt;PendingRequest&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Support&lt;/span&gt;\&lt;span class="nc"&gt;Facades&lt;/span&gt;\&lt;span class="nc"&gt;Http&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;PushinPay&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;private&lt;/span&gt; &lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;http&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nc"&gt;PendingRequest&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nc"&gt;Http&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;baseUrl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;config&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'services.pushinpay.base_url'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;withToken&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;config&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'services.pushinpay.token'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;acceptJson&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;timeout&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;createCharge&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;int&lt;/span&gt; &lt;span class="nv"&gt;$cents&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nv"&gt;$description&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kt"&gt;int&lt;/span&gt; &lt;span class="nv"&gt;$expiresIn&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;3600&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;array&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nv"&gt;$this&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;http&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;post&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'/api/pix/cashIn'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
            &lt;span class="s1"&gt;'value'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$cents&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="s1"&gt;'description'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;mb_substr&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$description&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;255&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="s1"&gt;'expires_in'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$expiresIn&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="s1"&gt;'webhook_url'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;route&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'webhooks.pushinpay'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="k"&gt;throw&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;find&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nv"&gt;$id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;array&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nv"&gt;$this&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;http&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"/api/transactions/{$id}"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="k"&gt;throw&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;refund&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nv"&gt;$id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;array&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nv"&gt;$this&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;http&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;post&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"/api/transactions/{$id}/refund"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="k"&gt;throw&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;O &lt;code&gt;-&amp;gt;throw()&lt;/code&gt; transforma resposta 4xx/5xx em exceção. Prefiro assim a descobrir lá na frente que salvei um pagamento com &lt;code&gt;id&lt;/code&gt; nulo.&lt;/p&gt;

&lt;h2&gt;
  
  
  Criando a cobrança no checkout
&lt;/h2&gt;

&lt;p&gt;No controller do checkout, a cobrança é criada e o retorno vai para uma tabela &lt;code&gt;payments&lt;/code&gt; ligada ao pedido:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="nv"&gt;$charge&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nv"&gt;$pushinPay&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;createCharge&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1990&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"Pedido {$order-&amp;gt;id}"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nv"&gt;$order&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;payment&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;create&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="s1"&gt;'pushinpay_id'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$charge&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'id'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s1"&gt;'status'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$charge&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'status'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s1"&gt;'value'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$charge&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'value'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s1"&gt;'qr_code'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$charge&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'qr_code'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Três cuidados que evitam chamado de suporte:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Centavos num lugar só.&lt;/strong&gt; Se o valor vem de formulário, valide antes de chamar a API (&lt;code&gt;'value' =&amp;gt; 'required|integer|min:50'&lt;/code&gt;) e converta reais para centavos uma única vez. Quando a conversão aparece em dois lugares, cedo ou tarde alguém cobra 100 vezes o valor.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Copia e cola visível.&lt;/strong&gt; Mostre o QR Code e, logo abaixo, o texto do &lt;code&gt;qr_code&lt;/code&gt; com um botão de copiar. Quem compra pelo celular quase sempre paga pelo copia e cola.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Imagem do QR.&lt;/strong&gt; Antes de montar o &lt;code&gt;src&lt;/code&gt; da imagem, confira se o &lt;code&gt;qr_code_base64&lt;/code&gt; já vem com o prefixo &lt;code&gt;data:image/...&lt;/code&gt;. Se você adicionar o prefixo duas vezes, a imagem quebra.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  A rota e o controller do webhook
&lt;/h2&gt;

&lt;p&gt;Quando o status da transação muda, a PushinPay faz um POST na &lt;code&gt;webhook_url&lt;/code&gt;. Você pode mandar a URL em cada cobrança, como no client acima, ou configurar uma por conta em &lt;code&gt;/api/accounts/webhooks&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;A rota fica em &lt;code&gt;routes/api.php&lt;/code&gt;, que não passa pela verificação de CSRF. Lembre que o Laravel coloca o prefixo &lt;code&gt;/api&lt;/code&gt; nessas rotas, então a URL final é &lt;code&gt;/api/webhooks/pushinpay&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="nc"&gt;Route&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;post&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'/webhooks/pushinpay'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;PushinPayWebhookController&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="k"&gt;class&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;name&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'webhooks.pushinpay'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Um erro comum em desenvolvimento é usar &lt;code&gt;localhost&lt;/code&gt; como &lt;code&gt;webhook_url&lt;/code&gt;. A PushinPay precisa conseguir chegar até essa URL, então ela tem que ser um endereço público.&lt;/p&gt;

&lt;p&gt;Com um segredo configurado, a requisição chega com os headers &lt;code&gt;x-pushinpay-token&lt;/code&gt; e &lt;code&gt;x-pushinpay-signature: sha256=&amp;lt;HMAC-SHA256&amp;gt;&lt;/code&gt;. No exemplo abaixo eu calculo o HMAC sobre o corpo bruto da requisição. Antes de ir para produção, confirme na documentação qual conteúdo entra no cálculo.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="o"&gt;&amp;lt;?&lt;/span&gt;&lt;span class="n"&gt;php&lt;/span&gt;

&lt;span class="k"&gt;namespace&lt;/span&gt; &lt;span class="nc"&gt;App&lt;/span&gt;\&lt;span class="nc"&gt;Http&lt;/span&gt;\&lt;span class="nc"&gt;Controllers&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;App&lt;/span&gt;\&lt;span class="nc"&gt;Jobs&lt;/span&gt;\&lt;span class="nc"&gt;SyncPushinPayTransaction&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Http&lt;/span&gt;\&lt;span class="nc"&gt;Request&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;PushinPayWebhookController&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;__invoke&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Request&lt;/span&gt; &lt;span class="nv"&gt;$request&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="nv"&gt;$secret&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;config&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'services.pushinpay.webhook_secret'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="nf"&gt;abort_if&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;blank&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$secret&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;500&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'Webhook secret não configurado'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="nv"&gt;$expected&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;'sha256='&lt;/span&gt; &lt;span class="p"&gt;.&lt;/span&gt; &lt;span class="nf"&gt;hash_hmac&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'sha256'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;$request&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;getContent&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;$secret&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="nv"&gt;$received&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nv"&gt;$request&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;header&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'x-pushinpay-signature'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="nf"&gt;abort_unless&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;hash_equals&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$expected&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;$received&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;401&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="c1"&gt;// confira o formato do payload na documentação&lt;/span&gt;
        &lt;span class="nv"&gt;$id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nv"&gt;$request&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;input&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'id'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
        &lt;span class="nf"&gt;abort_if&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;blank&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;422&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="nc"&gt;SyncPushinPayTransaction&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;dispatch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nf"&gt;response&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;noContent&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Incluí duas checagens que não estavam no meu primeiro rascunho. A primeira é o &lt;code&gt;abort_if&lt;/code&gt; para o segredo vazio. Sem ele, um &lt;code&gt;.env&lt;/code&gt; incompleto faz o HMAC ser calculado com chave vazia, e qualquer um que souber disso consegue gerar uma assinatura válida. A segunda é o &lt;code&gt;hash_equals&lt;/code&gt; em vez de &lt;code&gt;===&lt;/code&gt;, porque ele compara em tempo constante.&lt;/p&gt;

&lt;p&gt;O controller faz pouco de propósito: valida, põe na fila e responde. Em produção, use uma fila de verdade com worker rodando. Com &lt;code&gt;QUEUE_CONNECTION=sync&lt;/code&gt;, o webhook fica esperando a consulta à API terminar.&lt;/p&gt;

&lt;h2&gt;
  
  
  O job: consultar, travar, comparar
&lt;/h2&gt;

&lt;p&gt;Duas boas práticas que valem para qualquer webhook de pagamento:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;O mesmo evento pode chegar mais de uma vez.&lt;/strong&gt; O tratamento precisa ser idempotente.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Não confie só no corpo do webhook.&lt;/strong&gt; Confirme o status consultando a transação.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Por isso o job ignora o status do webhook e pergunta direto para a API com &lt;code&gt;GET /api/transactions/{id}&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="o"&gt;&amp;lt;?&lt;/span&gt;&lt;span class="n"&gt;php&lt;/span&gt;

&lt;span class="k"&gt;namespace&lt;/span&gt; &lt;span class="nc"&gt;App&lt;/span&gt;\&lt;span class="nc"&gt;Jobs&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;App&lt;/span&gt;\&lt;span class="nc"&gt;Models&lt;/span&gt;\&lt;span class="nc"&gt;Payment&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;App&lt;/span&gt;\&lt;span class="nc"&gt;Services&lt;/span&gt;\&lt;span class="nc"&gt;PushinPay&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Bus&lt;/span&gt;\&lt;span class="nc"&gt;Queueable&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Contracts&lt;/span&gt;\&lt;span class="nc"&gt;Queue&lt;/span&gt;\&lt;span class="nc"&gt;ShouldQueue&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Foundation&lt;/span&gt;\&lt;span class="nc"&gt;Bus&lt;/span&gt;\&lt;span class="nc"&gt;Dispatchable&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Queue&lt;/span&gt;\&lt;span class="nc"&gt;InteractsWithQueue&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Queue&lt;/span&gt;\&lt;span class="nc"&gt;SerializesModels&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Support&lt;/span&gt;\&lt;span class="nc"&gt;Facades&lt;/span&gt;\&lt;span class="no"&gt;DB&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;SyncPushinPayTransaction&lt;/span&gt; &lt;span class="k"&gt;implements&lt;/span&gt; &lt;span class="nc"&gt;ShouldQueue&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Dispatchable&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;InteractsWithQueue&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;Queueable&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;SerializesModels&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;int&lt;/span&gt; &lt;span class="nv"&gt;$tries&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;array&lt;/span&gt; &lt;span class="nv"&gt;$backoff&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;10&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;30&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;60&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;120&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;__construct&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nv"&gt;$id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;handle&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;PushinPay&lt;/span&gt; &lt;span class="nv"&gt;$pushinPay&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;void&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="nv"&gt;$transaction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nv"&gt;$pushinPay&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;find&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$this&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="no"&gt;DB&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;transaction&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$transaction&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="nv"&gt;$payment&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Payment&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;where&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'pushinpay_id'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;$transaction&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'id'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;lockForUpdate&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
                &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;firstOrFail&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$payment&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nv"&gt;$transaction&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'status'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// evento repetido, nada a fazer&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;

            &lt;span class="nv"&gt;$payment&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;update&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
                &lt;span class="s1"&gt;'status'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$transaction&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'status'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                &lt;span class="s1"&gt;'end_to_end_id'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$transaction&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'end_to_end_id'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$transaction&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'status'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'paid'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="nv"&gt;$payment&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;order&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;markAsPaid&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;O que cada parte resolve:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;lockForUpdate&lt;/code&gt; impede que dois workers processem o mesmo pagamento ao mesmo tempo.&lt;/li&gt;
&lt;li&gt;A comparação de status faz o evento repetido virar no-op.&lt;/li&gt;
&lt;li&gt;O &lt;code&gt;end_to_end_id&lt;/code&gt; fica salvo porque é ele que identifica o Pix no sistema bancário. Quando alguém precisar rastrear um pagamento, é esse número que vai pedir.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;$tries&lt;/code&gt; e &lt;code&gt;$backoff&lt;/code&gt; fazem o job tentar de novo se a consulta falhar por timeout ou instabilidade de rede.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Se algum webhook falhar do seu lado (servidor fora do ar, deploy no meio do caminho), dá para reenviar pelo painel ou pela API.&lt;/p&gt;

&lt;h2&gt;
  
  
  Os quatro status
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;created&lt;/code&gt;: cobrança gerada, pagamento pendente.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;paid&lt;/code&gt;: pago.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;canceled&lt;/code&gt;: falhou, expirou ou foi cancelado.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;refunded&lt;/code&gt;: estornado.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;O &lt;code&gt;canceled&lt;/code&gt; por expiração é o que mais aparece e o que menos recebe atenção. Quando a cobrança expira, libere o estoque reservado e deixe o cliente gerar uma cobrança nova sem montar o carrinho de novo.&lt;/p&gt;

&lt;h2&gt;
  
  
  Estorno e comprovante
&lt;/h2&gt;

&lt;p&gt;Esses dois endpoints costumam ficar para depois e fazem falta no primeiro atendimento:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Estorno:&lt;/strong&gt; &lt;code&gt;POST /api/transactions/{id}/refund&lt;/code&gt;. A transação vai para &lt;code&gt;refunded&lt;/code&gt; e o webhook avisa. Como o job já trata qualquer mudança de status, você não precisa de código extra para receber essa notificação.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Comprovante:&lt;/strong&gt; &lt;code&gt;GET /api/pix/voucher/{id}&lt;/code&gt;. Serve para o suporte responder rápido quando o cliente diz que já pagou.
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl https://api-sandbox.pushinpay.com.br/api/pix/voucher/ID_DA_TRANSACAO \
  -H &lt;span class="s2"&gt;"Authorization: Bearer SEU_TOKEN"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Accept: application/json"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Testes automatizados sem chamar a API
&lt;/h2&gt;

&lt;p&gt;Como todo o acesso passa pela classe &lt;code&gt;PushinPay&lt;/code&gt;, dá para simular as respostas com &lt;code&gt;Http::fake&lt;/code&gt; e testar o checkout no CI sem depender de rede:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Support&lt;/span&gt;\&lt;span class="nc"&gt;Facades&lt;/span&gt;\&lt;span class="nc"&gt;Http&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nc"&gt;Http&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;fake&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="s1"&gt;'*/api/pix/cashIn'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nc"&gt;Http&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;response&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="s1"&gt;'id'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'tx_teste'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s1"&gt;'qr_code'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'...'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s1"&gt;'qr_code_base64'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'...'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s1"&gt;'status'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'created'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s1"&gt;'value'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;1990&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Para o webhook, monte a assinatura no próprio teste com &lt;code&gt;hash_hmac('sha256', $corpo, $segredo)&lt;/code&gt;. Depois verifique que a assinatura certa devolve 204 e a errada devolve 401.&lt;/p&gt;

&lt;h2&gt;
  
  
  Checklist antes de trocar para produção
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Cobrança criada e paga no sandbox, com o pedido marcado como pago pelo job.&lt;/li&gt;
&lt;li&gt;Mesmo webhook enviado duas vezes, sem efeito duplicado.&lt;/li&gt;
&lt;li&gt;Webhook com assinatura errada recusado com 401.&lt;/li&gt;
&lt;li&gt;Segredo do webhook preenchido no &lt;code&gt;.env&lt;/code&gt; do servidor.&lt;/li&gt;
&lt;li&gt;Cobrança expirada tratada (estoque liberado, mensagem para o cliente).&lt;/li&gt;
&lt;li&gt;Estorno testado de ponta a ponta.&lt;/li&gt;
&lt;li&gt;Worker da fila rodando e monitorado.&lt;/li&gt;
&lt;li&gt;Token de produção só no &lt;code&gt;.env&lt;/code&gt; do servidor, nunca no repositório.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Se travar em algum ponto, o time da PushinPay acompanha a integração sem custo. Em geral a gente fecha em menos de 12 horas.&lt;/p&gt;

&lt;h2&gt;
  
  
  Links
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Site: &lt;a href="https://pushinpay.com.br" rel="noopener noreferrer"&gt;https://pushinpay.com.br&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Cadastro: &lt;a href="https://app.pushinpay.com.br/register" rel="noopener noreferrer"&gt;https://app.pushinpay.com.br/register&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Painel (token e webhooks): &lt;a href="https://app.pushinpay.com.br/app" rel="noopener noreferrer"&gt;https://app.pushinpay.com.br/app&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;LinkedIn: linkedin.com/company/pushin-pay&lt;/li&gt;
&lt;li&gt;YouTube: @PUSHINpaybr&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>braziliandevs</category>
      <category>pix</category>
      <category>laravel</category>
      <category>php</category>
    </item>
    <item>
      <title>Pix na API da PushinPay: cobrança, QR Code, webhook idempotente e conciliação</title>
      <dc:creator>David William Balbino</dc:creator>
      <pubDate>Mon, 16 Nov 2026 15:10:51 +0000</pubDate>
      <link>https://dev.to/david_williambalbino_7ec/como-integrar-pix-na-sua-aplicacao-com-a-api-da-pushinpay-cobranca-qr-code-webhook-e-consulta-21a9</link>
      <guid>https://dev.to/david_williambalbino_7ec/como-integrar-pix-na-sua-aplicacao-com-a-api-da-pushinpay-cobranca-qr-code-webhook-e-consulta-21a9</guid>
      <description>&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhcyp1as8s731l4ozfzix.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhcyp1as8s731l4ozfzix.png" alt="Pix na API da PushinPay: cobrança, QR Code, webhook idempotente e conciliação" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Um guia prático com curl e PHP/Laravel, do token no sandbox até o checklist de produção, incluindo os erros que mais vejo nas integrações.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;O bug de Pix que eu mais vejo em integração é o webhook que chega duas vezes. O cliente paga uma vez só, mas recebe dois e-mails de acesso, ou o estoque baixa em dobro. O código não tem nada de errado na sintaxe. Ele só partiu do pressuposto de que cada aviso chega uma única vez.&lt;/p&gt;

&lt;p&gt;Sou cofundador e diretor de produtos da PushinPay. Passo boa parte da semana em conversa com times que estão ligando o Pix em loja virtual, plataforma de infoproduto ou ERP. As perguntas quase sempre são as mesmas: onde pego o token, como mostro o QR Code, como sei que o cliente pagou, o que faço quando o aviso chega repetido.&lt;/p&gt;

&lt;p&gt;Neste texto eu junto as respostas. Tem &lt;code&gt;curl&lt;/code&gt;, para testar no terminal, e PHP com Laravel, para levar ao projeto.&lt;/p&gt;

&lt;h2&gt;
  
  
  Antes do primeiro request
&lt;/h2&gt;

&lt;p&gt;Você precisa de três coisas:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Conta na PushinPay.&lt;/strong&gt; O cadastro é em &lt;a href="https://app.pushinpay.com.br/register" rel="noopener noreferrer"&gt;https://app.pushinpay.com.br/register&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Token de API&lt;/strong&gt;, gerado no painel. Ele vai em todo request no header &lt;code&gt;Authorization: Bearer SEU_TOKEN&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;O host certo.&lt;/strong&gt; Para homologação e testes, use o sandbox: &lt;code&gt;api-sandbox.pushinpay.com.br&lt;/code&gt;. Em produção, é &lt;code&gt;api.pushinpay.com.br&lt;/code&gt;. Os caminhos dos endpoints são iguais nos dois.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Mande &lt;code&gt;Accept: application/json&lt;/code&gt; em todas as chamadas. Assim até a resposta de erro vem em JSON, e o seu código não precisa adivinhar o formato.&lt;/p&gt;

&lt;p&gt;Para trocar de ambiente sem mexer no código, eu deixo host e token no &lt;code&gt;.env&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;PUSHINPAY_BASE_URL=https://api-sandbox.pushinpay.com.br
PUSHINPAY_TOKEN=SEU_TOKEN
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;E registro no &lt;code&gt;config/services.php&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="s1"&gt;'pushinpay'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="s1"&gt;'base_url'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;env&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'PUSHINPAY_BASE_URL'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s1"&gt;'token'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;env&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'PUSHINPAY_TOKEN'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Gerando a cobrança
&lt;/h2&gt;

&lt;p&gt;O endpoint é &lt;code&gt;POST /api/pix/cashIn&lt;/code&gt;. O único campo que você precisa mandar é &lt;code&gt;value&lt;/code&gt;, &lt;strong&gt;em centavos&lt;/strong&gt;, com mínimo de 50 (R$ 0,50).&lt;/p&gt;

&lt;p&gt;Os opcionais que eu uso em quase toda integração:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Campo&lt;/th&gt;
&lt;th&gt;Para quê&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;webhook_url&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;URL que recebe o aviso quando o status muda&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;expires_in&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;validade em segundos, de 300 (5 min) a 172800 (48 h)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;description&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;texto livre, até 255 caracteres&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;split_rules[]&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;divide o valor entre contas: &lt;code&gt;value&lt;/code&gt; em centavos e &lt;code&gt;account_id&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;utms&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;utm_source&lt;/code&gt;, &lt;code&gt;utm_campaign&lt;/code&gt;, &lt;code&gt;utm_medium&lt;/code&gt;, &lt;code&gt;utm_content&lt;/code&gt;, &lt;code&gt;utm_term&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Uma cobrança de R$ 49,90 que vale por 30 minutos:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;curl -X POST https://api-sandbox.pushinpay.com.br/api/pix/cashIn \
  -H &lt;span class="s2"&gt;"Authorization: Bearer SEU_TOKEN"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Accept: application/json"&lt;/span&gt; \
  -H &lt;span class="s2"&gt;"Content-Type: application/json"&lt;/span&gt; \
  -d &lt;span class="s1"&gt;'{
    "value": 4990,
    "expires_in": 1800,
    "description": "Pedido 1234",
    "webhook_url": "https://seusite.com.br/webhooks/pushinpay?pedido=1234"
  }'&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Repare que é &lt;code&gt;4990&lt;/code&gt;, não &lt;code&gt;49.90&lt;/code&gt;. Mandar o valor em reais é o erro mais comum do primeiro dia. Se o seu banco guarda decimal, converta antes de montar o payload, e evite float nessa conta.&lt;/p&gt;

&lt;p&gt;Na resposta vêm:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;id&lt;/code&gt;: identificador da transação. &lt;strong&gt;Salve no pedido&lt;/strong&gt;, porque tudo depois depende dele.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;qr_code&lt;/code&gt;: o Pix copia e cola.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;qr_code_base64&lt;/code&gt;: a imagem do QR Code.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;status&lt;/code&gt;: nasce como &lt;code&gt;created&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;value&lt;/code&gt;, &lt;code&gt;end_to_end_id&lt;/code&gt;, &lt;code&gt;payer_name&lt;/code&gt;, &lt;code&gt;payer_national_registration&lt;/code&gt; e &lt;code&gt;split_rules&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;O &lt;code&gt;?pedido=1234&lt;/code&gt; na &lt;code&gt;webhook_url&lt;/code&gt; é proposital. Quando o aviso chegar, a própria URL já diz qual pedido é, sem depender do corpo da requisição.&lt;/p&gt;

&lt;h2&gt;
  
  
  O mesmo fluxo no Laravel
&lt;/h2&gt;

&lt;p&gt;O cliente HTTP do Laravel dá conta sem pacote extra. No ponto em que o pedido é fechado:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Support&lt;/span&gt;\&lt;span class="nc"&gt;Facades&lt;/span&gt;\&lt;span class="nc"&gt;Http&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nv"&gt;$resposta&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Http&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;baseUrl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;config&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'services.pushinpay.base_url'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;withToken&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;config&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'services.pushinpay.token'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;acceptJson&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;post&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'/api/pix/cashIn'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
        &lt;span class="s1"&gt;'value'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;total_centavos&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s1"&gt;'expires_in'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;1800&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s1"&gt;'description'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s2"&gt;"Pedido {$pedido-&amp;gt;id}"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="s1"&gt;'webhook_url'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;route&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'webhooks.pushinpay'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'pedido'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="k"&gt;throw&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;update&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="s1"&gt;'pushinpay_id'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$resposta&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'id'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s1"&gt;'pix_copia_cola'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$resposta&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'qr_code'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="s1"&gt;'status'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'aguardando_pagamento'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;O &lt;code&gt;-&amp;gt;throw()&lt;/code&gt; faz um 4xx ou 5xx virar exceção. Sem ele, um erro de validação passa em silêncio e você só descobre quando o &lt;code&gt;$resposta['id']&lt;/code&gt; não existe.&lt;/p&gt;

&lt;h3&gt;
  
  
  Mostrando o QR Code
&lt;/h3&gt;

&lt;p&gt;A imagem sai direto do base64. Se o campo já vier com o prefixo &lt;code&gt;data:image/png;base64,&lt;/code&gt;, use como está. Se não vier, acrescente o prefixo antes de jogar no &lt;code&gt;src&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;img&lt;/span&gt; &lt;span class="na"&gt;src&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"{{ $qrCodeBase64 }}"&lt;/span&gt; &lt;span class="na"&gt;alt&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"QR Code Pix do pedido"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;input&lt;/span&gt; &lt;span class="na"&gt;type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"text"&lt;/span&gt; &lt;span class="na"&gt;readonly&lt;/span&gt; &lt;span class="na"&gt;value&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"{{ $pedido-&amp;gt;pix_copia_cola }}"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Deixe o copia e cola sempre ao lado da imagem, de preferência com um botão de copiar. Quem compra pelo celular não tem como escanear a própria tela.&lt;/p&gt;

&lt;h2&gt;
  
  
  Quatro status, quatro decisões
&lt;/h2&gt;

&lt;p&gt;A lógica do pedido gira em torno de quatro valores de &lt;code&gt;status&lt;/code&gt;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;created&lt;/code&gt;: cobrança gerada, sem pagamento ainda.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;paid&lt;/code&gt;: pago.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;canceled&lt;/code&gt;: falhou, expirou ou foi cancelada.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;refunded&lt;/code&gt;: estornada.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Na maioria dos sistemas o mapeamento é direto: &lt;code&gt;paid&lt;/code&gt; libera o pedido, &lt;code&gt;canceled&lt;/code&gt; devolve o estoque reservado, &lt;code&gt;refunded&lt;/code&gt; dispara o fluxo de devolução.&lt;/p&gt;

&lt;h2&gt;
  
  
  O webhook
&lt;/h2&gt;

&lt;p&gt;Quando o status muda, a PushinPay faz um POST na &lt;code&gt;webhook_url&lt;/code&gt;. Se você não quiser mandar a URL em cada cobrança, dá para configurar um webhook por conta em &lt;code&gt;/api/accounts/webhooks&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Com um segredo configurado, a requisição chega com os headers &lt;code&gt;x-pushinpay-token&lt;/code&gt; e &lt;code&gt;x-pushinpay-signature&lt;/code&gt;, este no formato &lt;code&gt;sha256=&amp;lt;HMAC-SHA256&amp;gt;&lt;/code&gt;. Valide antes de qualquer outra coisa. A forma exata de montar a comparação está na documentação.&lt;/p&gt;

&lt;p&gt;A regra que eu repito em toda conversa: &lt;strong&gt;o webhook é gatilho, não fonte da verdade.&lt;/strong&gt; Recebeu o aviso, consulte a transação e decida com base no que a consulta devolveu. Isso vale para qualquer gateway, não é particularidade nossa.&lt;/p&gt;

&lt;p&gt;A rota (lembre de tirá-la da verificação de CSRF):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="nc"&gt;Route&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;post&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'/webhooks/pushinpay'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nc"&gt;PushinPayWebhookController&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="k"&gt;class&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;name&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'webhooks.pushinpay'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;O controller:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Http&lt;/span&gt;\&lt;span class="nc"&gt;Request&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Support&lt;/span&gt;\&lt;span class="nc"&gt;Facades&lt;/span&gt;\&lt;span class="no"&gt;DB&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Support&lt;/span&gt;\&lt;span class="nc"&gt;Facades&lt;/span&gt;\&lt;span class="nc"&gt;Http&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;PushinPayWebhookController&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;__invoke&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nc"&gt;Request&lt;/span&gt; &lt;span class="nv"&gt;$request&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="c1"&gt;// valide aqui x-pushinpay-signature com o seu segredo&lt;/span&gt;

        &lt;span class="nv"&gt;$pedido&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Pedido&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;findOrFail&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$request&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;query&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'pedido'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="nv"&gt;$transacao&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Http&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;baseUrl&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;config&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'services.pushinpay.base_url'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;withToken&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;config&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'services.pushinpay.token'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;acceptJson&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"/api/transactions/{$pedido-&amp;gt;pushinpay_id}"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="k"&gt;throw&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
            &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;json&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="no"&gt;DB&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;transaction&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;$transacao&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="nv"&gt;$pedido&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Pedido&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;lockForUpdate&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;find&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$transacao&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'status'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'paid'&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt; &lt;span class="o"&gt;!==&lt;/span&gt; &lt;span class="s1"&gt;'pago'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;update&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;
                    &lt;span class="s1"&gt;'status'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'pago'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                    &lt;span class="s1"&gt;'end_to_end_id'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$transacao&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'end_to_end_id'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
                &lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
                &lt;span class="c1"&gt;// liberar acesso, emitir nota, avisar o cliente&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;

            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$transacao&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'status'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'canceled'&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; &lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;status&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s1"&gt;'aguardando_pagamento'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
                &lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;update&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'status'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'cancelado'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
            &lt;span class="p"&gt;}&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

        &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nf"&gt;response&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;noContent&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;O que esse código resolve:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Aviso repetido.&lt;/strong&gt; O mesmo evento pode chegar mais de uma vez, inclusive ao mesmo tempo. O &lt;code&gt;lockForUpdate&lt;/code&gt; dentro da transação faz a segunda requisição esperar a primeira terminar. Quando ela entra, o pedido já está &lt;code&gt;pago&lt;/code&gt; e o &lt;code&gt;if&lt;/code&gt; não passa. O acesso é liberado uma vez só. É exatamente o bug do começo do texto.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Status vindo da consulta.&lt;/strong&gt; A decisão sai do &lt;code&gt;GET /api/transactions/{id}&lt;/code&gt;, não do corpo do POST.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;end_to_end_id&lt;/code&gt; salvo.&lt;/strong&gt; É o identificador do Pix no sistema bancário. Quando o cliente diz "eu paguei", é com ele que o suporte encerra a conversa.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Um cuidado extra: tudo o que fala com o mundo de fora (e-mail, nota fiscal) fica mais seguro em um job disparado depois do commit. Se o e-mail sair dentro da transação e o banco der rollback, o cliente recebe um aviso de algo que não foi gravado.&lt;/p&gt;

&lt;p&gt;Se o seu servidor cair e algum webhook falhar, dá para reenviar pelo painel ou pela API.&lt;/p&gt;

&lt;h2&gt;
  
  
  Consulta, estorno e comprovante
&lt;/h2&gt;

&lt;p&gt;A consulta já apareceu no webhook. Junto com ela, mais dois endpoints entram cedo em quase toda integração:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# consultar&lt;/span&gt;
curl https://api-sandbox.pushinpay.com.br/api/transactions/ID_DA_TRANSACAO \
  -H &lt;span class="s2"&gt;"Authorization: Bearer SEU_TOKEN"&lt;/span&gt; -H &lt;span class="s2"&gt;"Accept: application/json"&lt;/span&gt;

&lt;span class="c"&gt;# estornar&lt;/span&gt;
curl -X POST https://api-sandbox.pushinpay.com.br/api/transactions/ID_DA_TRANSACAO/refund \
  -H &lt;span class="s2"&gt;"Authorization: Bearer SEU_TOKEN"&lt;/span&gt; -H &lt;span class="s2"&gt;"Accept: application/json"&lt;/span&gt;

&lt;span class="c"&gt;# comprovante&lt;/span&gt;
curl https://api-sandbox.pushinpay.com.br/api/pix/voucher/ID_DA_TRANSACAO \
  -H &lt;span class="s2"&gt;"Authorization: Bearer SEU_TOKEN"&lt;/span&gt; -H &lt;span class="s2"&gt;"Accept: application/json"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Conciliação: a rede de segurança
&lt;/h2&gt;

&lt;p&gt;Aviso perdido é raro, mas acontece: deploy na hora errada, firewall novo, certificado vencido. Por isso eu sempre coloco uma rotina agendada que pega pedidos parados há mais tempo que o &lt;code&gt;expires_in&lt;/code&gt; e consulta a transação.&lt;/p&gt;

&lt;p&gt;No Laravel 11, em &lt;code&gt;routes/console.php&lt;/code&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Illuminate&lt;/span&gt;\&lt;span class="nc"&gt;Support&lt;/span&gt;\&lt;span class="nc"&gt;Facades&lt;/span&gt;\&lt;span class="nc"&gt;Schedule&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="nc"&gt;Schedule&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;call&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nc"&gt;Pedido&lt;/span&gt;&lt;span class="o"&gt;::&lt;/span&gt;&lt;span class="nf"&gt;where&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'status'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'aguardando_pagamento'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;where&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'created_at'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'&amp;lt;'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nf"&gt;now&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;subMinutes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;35&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;each&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$pedido&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
            &lt;span class="c1"&gt;// mesma consulta e mesma lógica do controller do webhook&lt;/span&gt;
        &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nf"&gt;everyTenMinutes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A dica aqui é tirar a lógica de dentro do &lt;code&gt;DB::transaction&lt;/code&gt; do controller e colocar numa classe própria, chamada pelos dois. Assim webhook e conciliação nunca divergem.&lt;/p&gt;

&lt;h2&gt;
  
  
  O caminho contrário: saque
&lt;/h2&gt;

&lt;p&gt;Se a sua aplicação também paga alguém (repasse a afiliado, devolução manual), o saque é &lt;code&gt;POST /api/pix/cashOut&lt;/code&gt; com:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;value&lt;/code&gt; em centavos, mínimo 100 (R$ 1,00);&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;pix_key&lt;/code&gt;;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;receiver_national_registration&lt;/code&gt;;&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;webhook_url&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A consulta fica em &lt;code&gt;GET /api/transfers/{id}&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;O token usado aqui precisa ter &lt;strong&gt;permissão de transferência&lt;/strong&gt;. Minha recomendação é ter um token separado só para saque, guardado apenas no serviço que faz isso. Se o token do checkout vazar, ninguém consegue mandar dinheiro para fora com ele.&lt;/p&gt;

&lt;h2&gt;
  
  
  Erros que eu vejo com frequência
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Valor em reais no lugar de centavos.&lt;/li&gt;
&lt;li&gt;Webhook que libera o pedido com base no corpo da requisição, sem consultar a transação.&lt;/li&gt;
&lt;li&gt;Webhook sem lock, que libera o mesmo pedido duas vezes.&lt;/li&gt;
&lt;li&gt;Rota do webhook barrada pelo CSRF, que devolve 419 e nunca processa nada.&lt;/li&gt;
&lt;li&gt;Só a imagem do QR Code na tela, sem o copia e cola.&lt;/li&gt;
&lt;li&gt;Deploy em produção com o &lt;code&gt;.env&lt;/code&gt; ainda apontando para o sandbox.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Checklist antes de ir para produção
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;[ ] Fluxo completo testado no sandbox: criar, pagar, receber webhook, consultar.&lt;/li&gt;
&lt;li&gt;[ ] Assinatura do webhook validada.&lt;/li&gt;
&lt;li&gt;[ ] Webhook idempotente, rodando dentro de transação no banco.&lt;/li&gt;
&lt;li&gt;[ ] &lt;code&gt;end_to_end_id&lt;/code&gt; salvo no pedido.&lt;/li&gt;
&lt;li&gt;[ ] Rotina de conciliação para pedidos em &lt;code&gt;created&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;[ ] Token de saque separado, se houver saque.&lt;/li&gt;
&lt;li&gt;[ ] &lt;code&gt;PUSHINPAY_BASE_URL&lt;/code&gt; apontando para &lt;code&gt;https://api.pushinpay.com.br&lt;/code&gt; e token de produção no &lt;code&gt;.env&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Se travar em algum ponto, o time da PushinPay acompanha a integração sem custo. Na maioria dos casos ela fica pronta em menos de 12 horas.&lt;/p&gt;

&lt;h2&gt;
  
  
  Links
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Site: &lt;a href="https://pushinpay.com.br" rel="noopener noreferrer"&gt;https://pushinpay.com.br&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Cadastro: &lt;a href="https://app.pushinpay.com.br/register" rel="noopener noreferrer"&gt;https://app.pushinpay.com.br/register&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Painel (token e webhooks): &lt;a href="https://app.pushinpay.com.br/app" rel="noopener noreferrer"&gt;https://app.pushinpay.com.br/app&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;YouTube: @PUSHINpaybr&lt;/li&gt;
&lt;li&gt;LinkedIn: company/pushin-pay&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>braziliandevs</category>
      <category>pix</category>
      <category>api</category>
      <category>php</category>
    </item>
    <item>
      <title>An idle chat app on a Galaxy S10: 3,543 CPU wakeups a minute on React Native, 130 on PAM Native</title>
      <dc:creator>David William Balbino</dc:creator>
      <pubDate>Mon, 16 Nov 2026 14:42:31 +0000</pubDate>
      <link>https://dev.to/david_williambalbino_7ec/our-idle-react-native-build-woke-the-cpu-3543-times-a-minute-on-pam-it-was-130-5g30</link>
      <guid>https://dev.to/david_williambalbino_7ec/our-idle-react-native-build-woke-the-cpu-3543-times-a-minute-on-pam-it-was-130-5g30</guid>
      <description>&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fo585owntl29rptsfyp70.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fo585owntl29rptsfyp70.png" alt="An idle chat app on a Galaxy S10: 3,543 CPU wakeups a minute on React Native, 130 on PAM Native" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;We left both builds of Zé Chat untouched on the inbox, measured wakeups, CPU, memory and mAh, and wrote down where PAM Native still comes out behind.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;The number we least expected was the background one.&lt;/p&gt;

&lt;p&gt;When a chat app leaves the screen, you assume it goes quiet. Our React Native build of Zé Chat kept using &lt;strong&gt;5.26% CPU&lt;/strong&gt; in the background on a Galaxy S10. The PAM Native build of the same app used &lt;strong&gt;0.11%&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;On screen, with the inbox open and nobody touching the phone, the gap looked the same. The RN build woke the CPU &lt;strong&gt;3,543 times per minute&lt;/strong&gt;, roughly 59 times a second, for a screen where nothing changed. The PAM build woke it &lt;strong&gt;130 times per minute&lt;/strong&gt;, about 2 a second.&lt;/p&gt;

&lt;p&gt;This post is only about that state: an app open or backgrounded, doing nothing. We cover how we measured, where the idle cost comes from in our RN build, why PAM has less to do at rest, and the cases where PAM loses.&lt;/p&gt;

&lt;h2&gt;
  
  
  The setup
&lt;/h2&gt;

&lt;p&gt;We built Zé Chat twice: once on React Native, once on PAM Native. Same app, same screens.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Device:&lt;/strong&gt; a real Galaxy S10, not an emulator.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Runs:&lt;/strong&gt; 3 per scenario. Every number below is the median.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Date:&lt;/strong&gt; October 15, 2026.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Scenarios:&lt;/strong&gt; idle on screen, idle in the background, and battery use across 10 idle minutes.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Each figure is a total for its scenario. We did not break wakeups down by source, so we can say how many there were, not exactly which component caused each one.&lt;/p&gt;

&lt;h2&gt;
  
  
  Results at rest
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Scenario&lt;/th&gt;
&lt;th&gt;PAM Native&lt;/th&gt;
&lt;th&gt;React Native&lt;/th&gt;
&lt;th&gt;Difference&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Wakeups per minute, idle on screen&lt;/td&gt;
&lt;td&gt;130&lt;/td&gt;
&lt;td&gt;3,543&lt;/td&gt;
&lt;td&gt;27.3x fewer&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;CPU, idle on screen&lt;/td&gt;
&lt;td&gt;0.3%&lt;/td&gt;
&lt;td&gt;8.62%&lt;/td&gt;
&lt;td&gt;28.7x less&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;CPU, in the background&lt;/td&gt;
&lt;td&gt;0.11%&lt;/td&gt;
&lt;td&gt;5.26%&lt;/td&gt;
&lt;td&gt;47.8x less&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Battery, 10 idle minutes&lt;/td&gt;
&lt;td&gt;0.05 mAh&lt;/td&gt;
&lt;td&gt;0.66 mAh&lt;/td&gt;
&lt;td&gt;13.3x less&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Memory at rest&lt;/td&gt;
&lt;td&gt;166 MB&lt;/td&gt;
&lt;td&gt;444 MB&lt;/td&gt;
&lt;td&gt;2.7x less&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The background row has the largest ratio of the set: 47.8x.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where the idle cost comes from in our RN build
&lt;/h2&gt;

&lt;p&gt;A static screen in React Native still has a JavaScript runtime behind it. In our build, the JavaScript engine, the bridge and the timers kept running while the screen was unchanged, and kept running after the app went to the background.&lt;/p&gt;

&lt;p&gt;One wakeup costs almost nothing. 59 of them every second is a different story: the CPU rarely gets to stay in a low-power state. Over hours, that becomes battery drain the user never triggered.&lt;/p&gt;

&lt;p&gt;This is not a claim that React Native is badly built. It is a design choice: a JavaScript runtime sits between app state and the native platform, and that runtime has its own work to do. Our numbers measure what that layer cost for this app on this phone.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why PAM has less to do at rest
&lt;/h2&gt;

&lt;p&gt;PAM Native has no JavaScript runtime, no WebView and no DOM. A user action travels this path:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;native event → PHP action → reactive state → Rust diff → UI-thread commit
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;PHP&lt;/strong&gt; holds component state (&lt;code&gt;#[State]&lt;/code&gt;) and actions.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Rust&lt;/strong&gt; validates the UI tree, diffs one screen against the next, and runs layout.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Kotlin and Swift&lt;/strong&gt; apply only the required changes to real Android Views and UIKit controls, on the UI thread.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A minimal component looks like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="o"&gt;&amp;lt;?&lt;/span&gt;&lt;span class="n"&gt;php&lt;/span&gt;

&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Pam&lt;/span&gt;\&lt;span class="nc"&gt;Native&lt;/span&gt;\&lt;span class="nc"&gt;Attributes&lt;/span&gt;\&lt;span class="nc"&gt;State&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;use&lt;/span&gt; &lt;span class="nc"&gt;Pam&lt;/span&gt;\&lt;span class="nc"&gt;Native&lt;/span&gt;\&lt;span class="nc"&gt;Component&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;final&lt;/span&gt; &lt;span class="k"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;Counter&lt;/span&gt; &lt;span class="k"&gt;extends&lt;/span&gt; &lt;span class="nc"&gt;Component&lt;/span&gt;
&lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="c1"&gt;#[State]&lt;/span&gt;
    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="kt"&gt;int&lt;/span&gt; &lt;span class="nv"&gt;$count&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="k"&gt;public&lt;/span&gt; &lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;increment&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;void&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="nv"&gt;$this&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="nb"&gt;count&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The key point for idle: the pipeline starts from an event. A tap, a gesture or new data kicks it off. An inbox with no input and no new messages gives it nothing to process.&lt;/p&gt;

&lt;p&gt;Three other choices point the same way:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Gestures&lt;/strong&gt; (tap, pan, pinch, rotate, swipe, long-press) are recognized on the UI thread.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Animations and gestures&lt;/strong&gt; run without per-frame traffic through PHP.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;PHP stays loaded.&lt;/strong&gt; PAM is a persistent runtime written in Rust that keeps the app in memory instead of starting it up and tearing it down for each piece of work.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;PAM does not reach zero. 130 wakeups per minute is still 130. The difference is the baseline: a native app with a small persistent runtime, instead of a native app plus a second runtime that has to keep busy.&lt;/p&gt;

&lt;h2&gt;
  
  
  Reading the battery number
&lt;/h2&gt;

&lt;p&gt;0.05 mAh and 0.66 mAh over 10 minutes are both small. A single idle session will not drain anyone's phone.&lt;/p&gt;

&lt;p&gt;The ratio is the useful part. A chat app spends most of its day open and idle or sitting in the background. If idle draw stayed linear (we did not test past 10 minutes, so treat this as arithmetic, not a measurement), one hour would be about 0.3 mAh on PAM and about 4 mAh on RN. Multiply that across a day, and across every app on the phone that keeps a runtime awake, and users start to notice.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where PAM still loses
&lt;/h2&gt;

&lt;p&gt;Idle is PAM's widest margin. It does not win everywhere. These are the losses in our measurements:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Rendering a 10,000-item list:&lt;/strong&gt; 991 ms on PAM vs. 654 ms on RN.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Video playback:&lt;/strong&gt; 61% CPU vs. 55%.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Reopening the app:&lt;/strong&gt; more network traffic, 26 KB vs. 5.2 KB.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Keypress-to-pixel filtering in the synthetic suite:&lt;/strong&gt; 70.5 ms vs. 49.1 ms.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;One detail on that last item, because it is easy to misread: it comes from a synthetic benchmark with a minimal app on an Android 16 emulator, run against React Native 0.85.3 with Hermes. In Zé Chat on the Galaxy S10, search from keypress to filtered list was 51 ms on PAM vs. 133 ms on RN. Both numbers are real. They measure different things, and we did not want to show only the one that favors us.&lt;/p&gt;

&lt;p&gt;With heavy work on screen, the gap shrinks, and in some cases RN is ahead. The ceiling for any framework is a fully native app. PAM gets close to it when there is UI on screen, but it does not beat it.&lt;/p&gt;

&lt;h2&gt;
  
  
  What these numbers do not tell you
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;One device.&lt;/strong&gt; Everything comes from a single Galaxy S10. Other phones, Android versions and battery conditions may produce different results.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Three runs.&lt;/strong&gt; Medians of 3 runs show a direction. They are not a full statistical study.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;One app.&lt;/strong&gt; These are numbers for our two builds of Zé Chat, not a statement about every React Native app. Another RN app, built differently, may idle better or worse.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Candidate builds.&lt;/strong&gt; Some PAM numbers come from candidate builds that are not yet in the public release.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;If you compare frameworks on your own app, one mistake to avoid: measuring only the foreground. In our case the background scenario showed the largest gap, and it is the state a chat app spends a lot of time in. Measure both, on a real device, over several runs, and compare medians.&lt;/p&gt;

&lt;h2&gt;
  
  
  Trying it
&lt;/h2&gt;

&lt;p&gt;PAM Native is open source under Apache-2.0. You write the app in typed PHP 8.5 and ship it to Android and iOS.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Install: &lt;code&gt;composer require pushinbr/pam-native&lt;/code&gt;
&lt;/li&gt;
&lt;li&gt;Docs: push-in.github.io/pam-docs/native/overview/&lt;/li&gt;
&lt;li&gt;PAM runtime: github.com/push-in/pam&lt;/li&gt;
&lt;li&gt;Issues: github.com/push-in/pam/issues&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;We are especially interested in idle numbers from other apps and devices, including the ones that disagree with ours.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Measurements from October 15, 2026: Zé Chat, Galaxy S10, median of 3 runs. The synthetic keypress-to-pixel figure comes from the Native × PAM × React Native 0.85.3 (Hermes) suite on an Android 16 emulator. Some PAM numbers come from candidate builds that are not yet in the public release.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;The code is at &lt;strong&gt;github.com/push-in/pam-native&lt;/strong&gt;. If you try it, open an issue with what you find, or leave a star if the project is useful to you.&lt;/p&gt;

</description>
      <category>reactnative</category>
      <category>mobileappdevelopment</category>
      <category>android</category>
      <category>php</category>
    </item>
  </channel>
</rss>
