Ordem de cobrança
A ordem de cobrança define quais gateways cobram o PIX e o cartão e em que sequência. Cada checkout escolhe a ordem que usa.
A ordem de cobrança é a lista dos gateways conectados que cobram os pagamentos de um grupo de checkouts e lojas, na sequência definida. No PIX, a principal cobra primeiro e, se falhar, a reserva entra. No cartão, cobra a primeira ativa. A conta pode ter até 5 ordens, e cada uma pode ser usada em vários checkouts e lojas.
Como a ordem cobra
Na tela, cada gateway conectado aparece como uma plataforma. Cada ordem tem uma lista de PIX e uma de cartão, com até 5 plataformas em cada. Um gateway recém-conectado não entra sozinho em nenhuma ordem: ele é incluído pelo vendedor.
| Forma de pagamento | Como a ordem cobra |
|---|---|
| PIX | A principal, 1ª plataforma conectada da lista, gera o PIX. Se ela falhar, a próxima reserva tenta, na ordem da lista, até uma conseguir. Se todas falharem, o comprador vê o PIX indisponível. |
| Cartão | Só a principal cobra. Se o cartão for recusado, não há nova tentativa. Assinaturas usam a primeira plataforma da lista que aceita cobrança recorrente. |
Números do topo
| Elemento | O que mostra |
|---|---|
| ordens de cobrança | Quantas ordens a conta tem, sobre o limite de 5. |
| checkouts cobrando | Quantos checkouts, e lojas quando houver, cobram por alguma ordem. |
| no modo automático | Quantas ordens estão com o modo automático ligado. |
| plataformas conectadas em uso | Plataformas conectadas que estão em alguma ordem, sobre o total conectado. |
| PRÓXIMA ATUALIZAÇÃO DAS MÉTRICAS | Contagem regressiva até a próxima leitura das taxas de cada plataforma. |
Suas ordens de cobrança
Cada ordem aparece em um card com o nome, a cobertura (Só a principal ou a quantidade de reservas, como + 1 reserva) e o uso, como Em 3 checkouts. Os selos PIX não cobra e Cartão não cobra indicam que nenhuma plataforma daquela lista está conectada. Clicar no card abre a ordem logo abaixo.
O botão Nova ordem de cobrança e o card Nova ordem criam uma ordem para outro grupo de checkouts e lojas. Com 5 ordens, é preciso excluir uma antes.
A ordem aberta
| Elemento | O que mostra |
|---|---|
| Nome | Nome da ordem (o lápis edita), com Criada em e Editada em. |
| Automático por estabilidade | Chave do modo automático. Ligado, o ggCheckout reordena as listas a cada 6 horas: o PIX pela plataforma mais estável e o cartão pela que mais aprova, com as taxas das últimas 24 horas. Desligado, você define a ordem arrastando a lista. |
| PIX e Cartão | Abas com a lista de cada forma de pagamento e a quantidade de plataformas sobre o limite, como 1/5. |
| Ajustes avançados | Seção recolhida, aberta pela seta. |
| Linha da plataforma | Alça para arrastar, posição, nome, o selo PRINCIPAL na primeira posição e a taxa das últimas 24 horas: estabilidade no PIX e aprovação no cartão. O ícone de informação abre O que é bom e O que pesa sobre a plataforma. |
| Cadeado | Trava a plataforma na posição. O modo automático não mexe nas travadas. |
| X | Tira a plataforma da lista. |
O PIX pode ser ordenado por Mais estável, que compara quem menos falha ao gerar o PIX, ou por Mais PIX pagos, que compara onde o comprador mais paga o PIX gerado. Com o segundo critério, o modo automático aparece como Automático por PIX pagos. No modo manual, o comando Ordenar PIX e cartão reordena as duas listas uma vez pelos mesmos critérios, sem mexer nas travadas.
Uso, exclusão e ID na API
Onde esta ordem de cobrança é usada abre a lista dos checkouts e lojas que cobram por ela. Cada item pode ir para outra ordem em Mover para….
Excluir ordem de cobrança remove a ordem sem possibilidade de recuperação. Os checkouts, lojas, webhooks e chaves de API dela passam para outra ordem. Quando ela é a única da conta, a tela mostra É a única ordem de cobrança: não pode ser excluída.
ID na API é o identificador da ordem, com botão de copiar. Ele vai no campo wallet de cada cobrança PIX feita pela API de pagamentos, e a cobrança passa pelas plataformas de PIX dessa ordem. A chave de API usada precisa ter acesso à ordem.
A ordem no checkout
Cada checkout escolhe a ordem no editor, na seção Pagamento, em Métodos de pagamento > Ordem de cobrança. O campo mostra o nome da ordem e um resumo, como 1 PIX · com cartão, e a tela informa: PIX e cartão seguem a ordem de cobrança. Parcelamento, desconto no PIX e comprovante continuam neste checkout. Nas lojas, a escolha fica em Pagamentos. As demais opções da seção estão em Formas de pagamento.
No painel
Ferramentas > Gateways > Ordem de cobrança.
Páginas relacionadas
- Formas de pagamento: os métodos aceitos e as opções da seção Pagamento do checkout.
- Ranking de estabilidade: a taxa de sucesso de cada gateway na plataforma.
- API de pagamentos: cobranças PIX por API, com o ID da ordem.