Status, confirmações e provas de pagamento

O ciclo de vida num relance#

open ──(payment seen)──▶ pending ──(enough confirmations, full amount)──▶ paid / overpaid
  │                        │
  │                        └─(quote expired + 10 min grace, still short)──▶ underpaid
  ├─(nothing arrives before expiry)──▶ expired
  ├─(payment seen only after quote expiry + 10 min)──▶ late
  └─(merchant cancels, no payment yet)──▶ canceled

Referência de status#

Cada mudança de status gera um evento de webhook (invoice.pending, invoice.paid, …). Veja Webhooks.

Quando uma fatura conta como paga?#

Para a moeda escolhida pelo comprador, o RugWard soma os pagamentos confirmados vistos antes da expiração da cotação mais 10 minutos de tolerância (assim, uma transação transmitida pouco antes do prazo ainda conta). A fatura fica:

• paid quando esse total é pelo menos o valor cotado menos uma pequena tolerância: o ajuste do valor único mais 0,1% (cobre carteiras que arredondam os últimos dígitos);
• overpaid quando ele passa mais de 1% do valor cotado.

Valores em moedas diferentes nunca são somados. Na Base, onde os 0,5% são divididos on-chain, a verificação é feita sobre os 99,5% que chegam a você.

Confirmações#

Como o RugWard detecta pagamentos#

Proteções embutidas na detecção:

• Uma transação paga uma fatura. Uma transação só pode ser creditada uma vez por rede e endereço de destino.
• Sem front-running. Um hash de transação colado por outra pessoa só é aceito se corresponder ao valor único exato desta cotação ou trouxer a reference dela.
• Sem transações antigas. Uma transação minerada antes de a cotação ser criada não pode pagá-la.
• Uma transação colada com valor diferente é recusada com "Contact the merchant with the transaction id"; o comerciante resolve manualmente.
• A cotação é calculada apenas no servidor; o navegador do comprador nunca fornece um preço.

Reembolsos#

O RugWard Pay é sem custódia: o dinheiro já está na sua carteira, então o RugWard não pode reembolsar, reverter nem estornar nada. Para reembolsar um comprador, devolva você mesmo as moedas da sua carteira, de preferência para um endereço que o comprador indicar (não automaticamente para o endereço de envio: ele pode pertencer a uma corretora). Guarde o id da fatura e os links das transações nos seus registros.

Provas de pagamento#

Toda fatura paid ou overpaid tem uma página de prova pública e compartilhável em https://rugward.com/pay/proof/<invoice id> (também em JSON em /api/pay/proof/<invoice id>). Ela mostra o valor em USD, o comerciante, quando foi confirmada, o valor em moeda cotado e a taxa com as fontes de preço, o endereço de recebimento e cada transação confirmada com link do explorador. Qualquer pessoa pode reconferir essas transações na blockchain pública.

As páginas de prova não são indexadas por buscadores. Faturas não pagas não têm prova (404).

A expiração em detalhe#

• Expiração da fatura (15 minutos a 7 dias): depois dela, nenhuma nova cotação pode ser travada.
• Expiração da cotação (trava de taxa): 30 minutos depois que o comprador escolhe uma moeda. Se restarem menos de 5 minutos, escolher a mesma moeda de novo trava uma nova cotação.
• Tolerância: pagamentos vistos até 10 minutos depois da expiração da cotação ainda contam normalmente.
• Uma fatura só passa a expired depois que tanto a fatura quanto a última cotação (mais a tolerância) terminam sem pagamento.