A variável {payment_url} retorna o link de pagamento correto para cada cliente — o boleto do PagSeguro, o link do Mercado Pago, o Pix do Juno, e por aí. O plugin sabe ler os dados de cada gateway e devolver a URL certa.
Como funciona
Quando você clica num botão de mensagem na lista de pedidos, o plugin:
- Identifica o método de pagamento que o cliente usou (
payment_methoddo pedido). - Consulta o meta correspondente do pedido (URL do boleto, dados da transação, etc) para extrair a URL de pagamento.
- Substitui
{payment_url}no texto pela URL encontrada. - Caso o gateway não esteja na lista de integrações nativas, devolve a URL padrão de checkout do WooCommerce —
pay_for_order— que abre a tela onde o cliente pode terminar o pagamento.
Gateways com integração nativa
Estes 20 gateways têm tratamento dedicado, retornando o link direto para o boleto/Pix em vez do checkout do WooCommerce:
| Gateway | Método (payment_method) |
Link retornado |
|---|---|---|
| PagSeguro | pagseguro (apenas Boleto) |
URL do boleto salva no meta URL de pagamento. |
| Itaú Shopline | itau-shopline |
URL do boleto via WC_Itau_Shopline::get_payment_url() |
| Mercado Pago Ticket | woo-mercado-pago-ticket |
URL salva no meta _transaction_details_ticket |
| bCash | bcash |
Endpoint do plugin com lembrete do boleto |
| Pagar.me Banking Ticket | pagarme-banking-ticket |
boleto_url da transação |
| Moip Boleto | woo-moip-official (com payBoleto) |
printHref do meta _moip_payment_links |
| PagHiper Boleto | paghiper |
urlPdfPagamento do meta wc_paghiper_data |
| PagHiper Billet | paghiper_billet |
url_slip do meta wc_paghiper_data |
| MundiPagg Banking Ticket | mundipagg-banking-ticket |
url do meta _mundipagg_banking_ticket_data |
| Cielo Webservice Boleto (J.Rossetto) | jrossetto_woo_cielo_webservice_boleto |
URL salva em _transacao_boletoURL |
| Boleto Fácil | boletofacil |
URL salva em boletofacil_url |
| Itaú Shopline (Loja5) | loja5_woo_itau_shopline |
Link em loja5_woo_itau_shopline_link_boleto |
| Bradesco API (Loja5) | loja5_woo_bradesco_api_boleto |
link_boleto do meta loja5_woo_bradesco_api_boleto_dados |
| Juno Bank Slip | juno-bank-slip |
installmentLink da resposta Juno |
| Juno Pix | juno-pix |
URL do detalhamento do Pix (filtro woo_juno_pay_pix_url) |
| Widepay | widepay |
URL salva em URLpagamento |
| Asaas Ticket | asaas-ticket |
bankSlipUrl da resposta Asaas |
| Mercado Pago Boleto (Loja5) | loja5_woo_mercadopago_boleto |
external_resource_url em _mercadopago_transacao |
| Vindi Bank Slip | vindi-bank-slip |
URL em vindi_wc_invoice_download_url |
| EBANX Banking Ticket | ebanx-banking-ticket |
URL salva em _boleto_url |
Outros gateways
Para qualquer outro gateway (Stripe, PicPay, Banco Inter, etc), {payment_url} recebe a URL de checkout do WooCommerce que o cliente pode usar pra completar o pagamento — o equivalente a clicar em "pagar" no e-mail de pedido.
https://sualoja.com.br/checkout/pedido-pagamento/1234/?pay_for_order=true&key=...
Se você usa um gateway que não está na lista e quer que {payment_url} retorne o link direto do boleto/Pix, dá pra adicionar via filtro PHP. Veja Adicionar gateway de pagamento customizado.
Quando o link direto não existe
Algumas situações em que o plugin cai no fallback do checkout do WooCommerce mesmo com gateway integrado:
- Pedido feito antes do gateway salvar o boleto no meta.
- Boleto expirou e o gateway não recriou link.
- Plugin do gateway foi desinstalado (a classe sumiu).
Nesse caso, a URL ainda funciona — o cliente cai na página de pagamento do WooCommerce e pode regerar o boleto/refazer o Pix.
Não envie {payment_url} sem pagamento
Se você marcou um pedido manualmente como Concluído ou Reembolsado, {payment_url} retorna a URL de visualização do pedido — não tem sentido cobrar pagamento de algo já pago. Filtre os status na aba Pedidos para evitar incluir pedidos que não precisam de cobrança.