Redes e ativos

Redes e ativos vêm de um registro de capacidades no servidor, exposto publicamente:

• GET /v1/networks e GET /v1/assets — todas as redes e todos os ativos que o gateway conhece, com o status de cada um
• GET /v1/capabilities — redes, ativos e meios de pagamento em uma única resposta

Leia o registro em tempo de execução; não o deixe fixo no código. O registro é a referência oficial, e a API recusa tudo o que não for utilizável no seu ambiente. Nesta plataforma só podem ser usadas as entradas com environment: "live" e status enabled (ou beta); entradas com environment: "test" não podem ser usadas para pagamentos aqui.

Disponibilidade das redes

O FeitPay habilita as redes e os ativos live no registro; uma entrada que não pode ser usada aparece como disabled. Os pagamentos são ativados após a verificação e aprovação da sua conta, e nada nesta documentação deve ser lido como promessa de que uma rede ou um ativo específico será oferecido.

Ativos aceitos pelos pagamentos live

Os pagamentos live são processados pela conta Bitcart da plataforma, que oferece todos os ativos que a plataforma aceita. Para cada pagamento você pode ver o que está sendo oferecido:

• o processor.methods da sessão de checkout — uma entrada por ativo aceito, com a chave do ativo (o símbolo da moeda, mais a cadeia no caso de tokens), a cadeia, o valor exato, a taxa de câmbio usada pela Bitcart e o endereço para pagamento;
• GET /v1/payout-assets — os ativos mantidos nas carteiras da plataforma, que também são os ativos que você pode sacar.

Você não pode restringir os ativos por intenção de pagamento: allowed_networks é recusado em pagamentos live (allowed_networks_unsupported).

Confirmações

Para pagamentos live, a Bitcart decide quando um pagamento é final usando a própria política de confirmação: apenas o status de fatura complete da Bitcart torna uma intenção confirmed, e o FeitPay registra esse status como evidência do processador — nunca como uma observação própria da cadeia.

Para o processamento somente de observação (o modo não custodial descrito em Carteiras, que esta plataforma não usa para pagamentos), cada rede do registro tem uma política de confirmação (um padrão e faixas opcionais por valor); o número que vale para um pagamento fica congelado na cotação como required_confirmations. As confirmações são calculadas pelo gateway a partir do topo da cadeia que ele observou — uma única resposta não confirmada de um provedor nunca é tratada como final.

Identidade dos tokens

No processamento somente de observação, um pagamento em token só é creditado quando todos estes itens correspondem à entrada do registro do ativo cotado:

1. rede (chain id),
2. endereço do contrato (forma canônica),
3. casas decimais (do registro — nunca da transferência nem do watcher).

Tokens com taxa na transferência, rebasing ou semântica não padrão de outro tipo são rejeitados, a menos que sejam explicitamente suportados. Símbolos e nomes servem apenas para exibição e nunca são usados na correspondência.

Pagamentos live

Nos pagamentos live, o ativo de cada meio de pagamento — incluindo a cadeia e o contrato de um token — é o que aparece em processor.methods, e o valor creditado ao seu saldo é o que a Bitcart informa para o meio de pagamento que foi pago.

Taxas e moedas nativas

Nas redes EVM o cliente paga o gas na moeda nativa, além do valor devido. Os pagamentos live chegam às carteiras Bitcart da plataforma, e a taxa de rede de um saque é paga pela carteira quente da plataforma.