{"id":4350,"date":"2026-07-07T19:54:33","date_gmt":"2026-07-07T22:54:33","guid":{"rendered":"https:\/\/www.magenteiro.com\/blog\/?p=4350"},"modified":"2026-07-07T19:54:34","modified_gmt":"2026-07-07T22:54:34","slug":"guest-checkout-bloqueado-na-api-rest","status":"publish","type":"post","link":"https:\/\/www.magenteiro.com\/blog\/magento-2\/guest-checkout-bloqueado-na-api-rest\/","title":{"rendered":"Guest checkout bloqueado na API REST do Magento 2? Confira isso."},"content":{"rendered":"\n

Semana passada apareceu um caso cl\u00e1ssico de \u201cconfigura\u00e7\u00e3o certa, mas erro mesmo assim\u201d.<\/p>\n\n\n\n

Limpei caches, conferi opcache, core_config_data, e nada.<\/p>\n\n\n\n

Checkout de visitantes habilitado no admin (Vendas \u2192 Checkout \u2192 Permitir compra sem login), carrinho guest criado normalmente via API, mas na hora de chamar o endpoint de shipping information\u2026 boom:<\/p>\n\n\n\n

{\n    \"message\": \"Sinto muito, a compra por convidados n\u00e3o est\u00e1 dispon\u00edvel.\"\n}<\/pre>\n\n\n\n
Se voc\u00ea integra Magento com PWA, app mobile ou qualquer checkout headless, provavelmente j\u00e1 passou por algo parecido \u2014 ou vai passar em breve, especialmente se estiver no\u00a0Magento 2.4.8+.<\/p>\n\n\n\n
Vou contar o que descobri, porque a mensagem engana, e como resolver de verdade.<\/p>\n\n\n\n
O sintoma<\/h2>\n\n\n\n
Voc\u00ea cria o carrinho guest:<\/p>\n\n\n\n
POST \/rest\/default\/V1\/guest-carts<\/code><\/p>\n\n\n\n
Adiciona produtos, define endere\u00e7o, e na sequ\u00eancia:<\/p>\n\n\n\n
POST \/rest\/default\/V1\/guest-carts\/{cartId}\/shipping-information<\/code><\/p>\n\n\n\n
A resposta vem com erro 400 e a mensagem traduzida acima.<\/p>\n\n\n\n
No stack trace (se voc\u00ea olhar com calma), aparece algo assim:<\/p>\n\n\n\n
Magento\\Checkout\\Plugin\\Api\\VerifyIsGuestCheckoutEnabledBeforeSaveShippingInformation\n  ->beforeSaveAddressInformation(...)<\/pre>\n\n\n\n
Ou seja: n\u00e3o \u00e9 bug do seu m\u00f3dulo de pagamento, nem do tema, nem do PWA. \u00c9 valida\u00e7\u00e3o nativa do Magento.<\/p>\n\n\n\n
A primeira suspeita (e por que ela engana)<\/h2>\n\n\n\n
Obviamente a primeira coisa que todo mundo checa \u00e9 a config:<\/p>\n\n\n\n
Vendas \u2192 Checkout \u2192 Op\u00e7\u00f5es de Checkout \u2192 Permitir compra sem login<\/p>\n\n\n\n
No banco, isso corresponde a:<\/p>\n\n\n\n
checkout\/options\/guest_checkout<\/code><\/p>\n\n\n\n
No meu caso:<\/p>\n\n\n\n
  • Config no escopo default: 1<\/code><\/li>
  • Config no escopo stores (store_id 1): 1<\/code><\/li>
  • bin\/magento config:show checkout\/options\/guest_checkout --scope=stores --scope-code=default<\/code> \u2192 1<\/code><\/li>
  • Carrinho com store_id = 1<\/code>, customer_is_guest = 1<\/code><\/li><\/ul>\n\n\n\n
    Tudo certo. E mesmo assim o erro persistia.<\/p>\n\n\n\n
    Aqui mora a pegadinha: existem duas regras diferentes, e s\u00f3 a primeira aparece na tela que todo mundo olha.<\/p>\n\n\n\n
    O que realmente acontece por baixo dos panos<\/h2>\n\n\n\n
    A partir do Magento 2.4.8, o core passou a validar guest checkout tamb\u00e9m na REST API \u2014 n\u00e3o s\u00f3 no checkout tradicional do frontend.<\/p>\n\n\n\n
    O plugin respons\u00e1vel \u00e9 o VerifyIsGuestCheckoutEnabledBeforeSaveShippingInformation<\/code>, que roda antes de salvar o endere\u00e7o de entrega em:<\/p>\n\n\n\n
    GuestShippingInformationManagement::saveAddressInformation()<\/code><\/p>\n\n\n\n
    A l\u00f3gica \u00e9 simples:<\/p>\n\n\n\n
    if (!$this->checkoutHelper->isAllowedGuestCheckout($quote)) {\n    throw new CouldNotSaveException(__('Sorry, guest checkout is not available.'));\n}<\/pre>\n\n\n\n
    At\u00e9 aqui, tudo previs\u00edvel. O problema \u00e9\u00a0o que entra dentro de\u00a0isAllowedGuestCheckout()<\/code>.<\/p>\n\n\n\n
    Esse helper n\u00e3o olha s\u00f3 a config checkout\/options\/guest_checkout<\/code>. Quando ela est\u00e1 habilitada, ele dispara o evento:<\/p>\n\n\n\n
    checkout_allow_guest<\/code><\/p>\n\n\n\n
    E \u00e9 a\u00ed que entra o m\u00f3dulo\u00a0Downloadable<\/strong>.<\/p>\n\n\n\n
    A mudan\u00e7a que pegou muita gente de surpresa (2.4.8+)<\/h2>\n\n\n\n
    Em vers\u00f5es anteriores, o observer que bloqueia guest checkout por causa de produtos download\u00e1veis<\/em> rodava basicamente no\u00a0frontend.<\/p>\n\n\n\n
    No 2.4.8-p3, a Adobe registrou o observer tamb\u00e9m em:<\/p>\n\n\n\n
    • etc\/webapi_rest\/events.xml<\/code><\/li>
    • etc\/graphql\/events.xml<\/code><\/li><\/ul>\n\n\n\n
      Ou seja: headless tamb\u00e9m passa por essa valida\u00e7\u00e3o agora.<\/p>\n\n\n\n
      O observer \u00e9 o\u00a0Magento\\Downloadable\\Observer\\IsAllowedGuestCheckoutObserver<\/code>.<\/p>\n\n\n\n
      Ele percorre os itens do carrinho. Se encontrar produto do tipo downloadable<\/code>, verifica:<\/p>\n\n\n\n
      1. catalog\/downloadable\/disable_guest_checkout<\/code> \u2014 por padr\u00e3o vem 1<\/code> (Sim)<\/li>
      2. Se os links do produto s\u00e3o shareable (compartilh\u00e1veis)<\/li><\/ol>\n\n\n\n
        Se qualquer condi\u00e7\u00e3o falhar, ele faz:<\/p>\n\n\n\n
        $result->setIsAllowed(false);<\/p>\n\n\n\n
        E pronto: guest checkout bloqueado, mesmo com \u201cPermitir compra sem login\u201d habilitado no admin.<\/p>\n\n\n\n
        Por que a mensagem \u00e9 t\u00e3o gen\u00e9rica?<\/h2>\n\n\n\n
        Porque o plugin lan\u00e7a sempre a mesma exce\u00e7\u00e3o:<\/p>\n\n\n\n
        Sorry, guest checkout is not available.<\/p>\n\n\n\n
        Traduzida no pt_BR:<\/p>\n\n\n\n
        Sinto muito, a compra por convidados n\u00e3o est\u00e1 dispon\u00edvel.<\/p>\n\n\n\n
        N\u00e3o diz \u201cseu carrinho tem produto downloadable\u201d. N\u00e3o aponta qual config resolver. Voc\u00ea fica ca\u00e7ando fantasma na config de checkout \u2014 exatamente o que aconteceu conosco.<\/p>\n\n\n\n
        Como diagnosticar em 2 minutos<\/h2>\n\n\n\n
        1. Confirme se o carrinho tem produto downloadable<\/h3>\n\n\n\n
        SELECT qi.item_id, qi.sku, qi.name, p.type_id<\/p>\n\n\n\n
        FROM quote_item qi<\/p>\n\n\n\n
        JOIN quote_id_mask m ON m.quote_id = qi.quote_id<\/p>\n\n\n\n
        JOIN catalog_product_entity p ON p.entity_id = qi.product_id<\/p>\n\n\n\n
        WHERE m.masked_id = ‘SEU_MASKED_CART_ID’;<\/p>\n\n\n\n
        Se aparecer type_id = downloadable<\/code>, voc\u00ea achou o culpado.<\/p>\n\n\n\n
        2. Confira as configs do m\u00f3dulo Downloadable<\/h3>\n\n\n\n
        bin\/magento config:show catalog\/downloadable\/disable_guest_checkout --scope=stores --scope-code=default<\/code><\/p>\n\n\n\n
        bin\/magento config:show catalog\/downloadable\/shareable --scope=stores --scope-code=default<\/code><\/p>\n\n\n\n
        Valores padr\u00e3o do Magento:<\/p>\n\n\n\n
        Config<\/th>Path<\/th>Default<\/th><\/tr><\/thead>
        Desabilitar guest checkout com download\u00e1veis<\/td>catalog\/downloadable\/disable_guest_checkout<\/code><\/td>1 (Sim)<\/td><\/tr>
        Links compartilh\u00e1veis<\/td>catalog\/downloadable\/shareable<\/code><\/td>0 (N\u00e3o)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        Ou seja: por padr\u00e3o, guest checkout + downloadable = bloqueado. E isso \u00e9 intencional.<\/p>\n\n\n\n
        3. Confirme que a config geral de guest checkout est\u00e1 OK (para descartar)<\/h3>\n\n\n\n
        bin\/magento config:show checkout\/options\/guest_checkout –scope=stores –scope-code=default<\/p>\n\n\n\n
        Se retornar 1<\/code> e o erro continuar com downloadable no carrinho, o caso est\u00e1 fechado.<\/p>\n\n\n\n
        Como resolver (depende da regra de neg\u00f3cio)<\/h2>\n\n\n\n
        Op\u00e7\u00e3o A \u2014 Permitir guest checkout com produtos download\u00e1veis<\/h3>\n\n\n\n
        Admin:<\/p>\n\n\n\n
        Cat\u00e1logo \u2192 Op\u00e7\u00f5es de Produto para Download \u2192 Desabilitar checkout de convidado se o carrinho contiver itens para download \u2192 N\u00e3o<\/p>\n\n\n\n
        Ou via CLI:<\/p>\n\n\n\n
        bin\/magento config:set catalog\/downloadable\/disable_guest_checkout 0 --scope=stores --scope-code=default<\/code><\/p>\n\n\n\n
        bin\/magento cache:flush config<\/code><\/p>\n\n\n\n
        Use isso se voc\u00ea quer vender arquivos digitais sem exigir cadastro.<\/p>\n\n\n\n
        Op\u00e7\u00e3o B \u2014 Exigir login para download\u00e1veis (padr\u00e3o recomendado)<\/h3>\n\n\n\n
        Mantenha disable_guest_checkout = 1<\/code> e oriente o cliente a criar conta ou fazer login antes do checkout.<\/p>\n\n\n\n
        Faz sentido quando:<\/p>\n\n\n\n
        • O link de download precisa ficar associado a um customer<\/li>
        • Voc\u00ea quer reduzir fraude ou abuso de links<\/li>
        • A entrega digital depende de \u00e1rea logada do cliente<\/li><\/ul>\n\n\n\n