O fluxo de pagamento por correio
- O comprador clica no botão Coin Moebius no seu site e escolhe "Pagamento por correio" no seletor. Ele vê uma pré-visualização primeiro: o seu endereço de correspondência, o valor devido, e quaisquer instruções que você definir, com um botão <strong>"Confirmo, vou enviar o pagamento"</strong>. Nada é registrado ainda, e não há código de referência nesta etapa.
- O comprador clica em "Confirmo, vou enviar o pagamento." Essa é a etapa que cria a transação: Coin Moebius gera um código de referência único como
X2M-K9P-R7QWe o mostra ao lado do seu endereço de correspondência. O comprador coloca o código de referência dentro do pacote ou no cheque. - Depois que ele confirma, uma linha aparece na aba Transações do seu painel com status
pending_manual. O topo da lista também mostra um aviso lembrando você de que confirmações de pagamento por correio estão aguardando. - Quando o pagamento do comprador chega na sua caixa de correio (dinheiro, cheque, Goldback, qualquer que fosse a moeda esperada), digite o código de referência na caixa de busca da aba Transações para encontrar a linha correspondente. Clique em Marcar como recebido. A URL de sucesso do comprador é disparada (para que ele receba uma página de confirmação), e você prossegue para enviar o que ele comprou.
- Se o pagamento do comprador nunca chega, a linha expira automaticamente após 30 dias. Você também pode Cancelar uma linha manualmente antes disso.
- Se você confirmou o recebimento mas depois descobre que o pagamento era inválido (falso, item errado, envelope vazio), clique em Desfazer confirmação na linha. O status muda para
manual_revoked. Isso corrige os seus registros no painel. Comunicar-se com o comprador sobre o que acontece a seguir é entre você e ele.
Testando o pagamento por correio
O pagamento por correio não tem sandbox, nem chaves de teste, nem conta externa para configurar. Todo o fluxo acontece entre o seu site e o seu painel. Há duas formas de testá-lo: o ciclo completo a partir de um botão de compra em uma página, ou um teste rápido direto do painel.
Teste rápido a partir do painel
O painel pode criar uma transação de teste para qualquer provedor sem envolver um pagamento real. Isso é útil para ver como uma linha de transação fica, praticar o fluxo de "Marcar como recebido" para o pagamento por correio, ou pré-visualizar como um pagamento em cripto aparece na sua lista antes de gastar dinheiro de verdade.
- Abra a aba Transações no seu projeto e clique em Enviar um evento de teste.
- Escolha um produto, escolha o que aconteceu (pagamento, reembolso, pagamento por correio, renovação de assinatura), e escolha o provedor que você quer simular (Stripe, NOWPayments, ou Pagamento por correio). Para eventos de pagamento por correio, o provedor é definido automaticamente.
- Clique em Enviar evento de teste. Uma nova linha aparece marcada como "teste" para que não se misture com dados reais. A linha aparece sob o filtro de provedor correto, exatamente como uma transação real apareceria.
Para o pagamento por correio especificamente, escolha "Um pedido de pagamento por correio está aguardando" para criar uma linha pending_manual com um código de referência real. Você pode então praticar clicar em "Marcar como recebido," "Cancelar," e "Desfazer confirmação" nela.
Os eventos de teste não contam para a sua cota mensal de transações.
Ciclo completo a partir de um botão de compra
Para testar o fluxo completo (do que o seu comprador vê até o que você vê), percorra estes passos. A coisa toda leva cerca de dois minutos.
- Configure o provedor. No seu painel, vá até a aba Provedores do seu projeto e clique em "Adicionar provedor" → Pagamento por correio. Insira qualquer endereço de correspondência (o seu próprio serve para testar) e qualquer moeda (por exemplo,
USD,GBK). Salve. - Adicione um produto. Na aba Produtos, crie um produto com um nome como "Item de teste" e um preço. Defina a moeda para combinar com o que você inseriu para o provedor.
- Coloque o botão de compra em uma página. Cole o HTML do botão de compra em qualquer página, até mesmo um arquivo HTML simples no seu computador. Aponte o atributo
endpointpara a URL do seu projeto Cloud. Se você está rodando o worker localmente, usehttp://localhost:8787em vez disso. - Clique no botão e escolha "Pagamento por correio." O seletor abre mostrando cada provedor que você conectou. Escolha "Pagamento por correio." Você verá uma pré-visualização com o seu endereço de correspondência, o valor e a moeda esperados, e um botão "Confirmo, vou enviar o pagamento". Sem código de referência ainda.
- Clique em "Confirmo, vou enviar o pagamento." É o comprador se comprometendo a enviar o pagamento. Coin Moebius registra a transação e mostra um código de referência como
X2M-K9P-R7QW. - Abra o painel. Vá até a aba Transações. Uma nova linha aparece com status
pending_manuale o mesmo código de referência que você acabou de ver. Se esta for a sua primeira linha pendente, um aviso no topo da lista lembra você de que pagamentos por correio estão aguardando confirmação. - Clique em "Marcar como recebido." O status da linha muda para
succeeded. Esse é o caminho feliz completo, do clique do comprador até a sua confirmação.
Encontrando uma transação pelo código de referência
Quando um pagamento chega na sua caixa de correio, procure pelo código de referência que o comprador incluiu (impresso no envelope, escrito no campo de memo do cheque, ou enfiado dentro do pacote). Depois digite esse código na caixa de busca da aba Transações e pressione Enter. A tabela filtra para as linhas correspondentes para que você possa clicar em "Marcar como recebido" na certa sem folhear todo o seu histórico de transações.
Testando os outros desfechos
Percorra os mesmos passos de novo, mas em vez de marcar a linha como recebida, tente cada um destes:
- Cancele. Clique em "Cancelar" na linha pendente. O status muda para
manual_canceled. É o que você faria quando um comprador diz que mudou de ideia antes de enviar qualquer coisa. - Deixe expirar. Deixe uma linha pendente em paz. Após 30 dias ela expira automaticamente para
manual_expired. Você não precisa esperar 30 dias para verificar o comportamento. A expiração funciona igual ao Cancelar, exceto que acontece automaticamente em um cronograma. - Insira um valor diferente. Ao clicar em "Marcar como recebido," insira um valor recebido que difira do que era esperado (por exemplo, o comprador enviou 4 Goldbacks em vez de 5). A transação ainda é bem-sucedida, mas o painel mostra tanto o valor esperado quanto o recebido para que os seus registros reflitam o que de fato chegou.
- Desfaça uma confirmação. Primeiro marque uma linha como recebida para que ela mostre
succeeded, depois clique em "Desfazer confirmação" naquela linha. O status muda paramanual_revoked. É assim que você corrigiria um engano ou sinalizaria um pagamento que acabou sendo inválido depois do fato.
O que observar
- O código de referência no seletor combina com o código de referência na linha do painel.
- O seu endereço de correspondência é exibido corretamente no seletor.
- Os botões "Marcar como recebido" e "Cancelar" aparecem apenas em linhas
pending_manual, não em transações de cartão ou cripto. - Após marcar como recebido, a linha mostra
succeededcom o valor correto. - Buscar pelo código de referência na caixa de busca encontra a linha certa.
As transações de ciclo completo criadas durante o teste contam para a sua cota mensal. No plano gratuito (150 transações/mês), um punhado de execuções de teste não fará diferença. Os eventos de teste enviados pelo botão "Enviar um evento de teste" do painel não contam nada.