Como aceitar pagamentos em USDC online

Para aceitar USDC online com a Cosmos Pay, adicione a carteira que vai receber o dinheiro e cobre com um link de pagamento, o checkout hospedado ou a API de pagamentos. Seu cliente paga com a própria carteira na Stellar, Solana ou Monad, e o USDC vai para o seu endereço. Faça tudo numa rede de testes antes de cobrar dinheiro real.

O que você precisa

Uma conta na Cosmos Pay. Criar uma é grátis, e o plano Starter não tem mensalidade: cada pagamento paga 1.5% + 18¢.

Um endereço de carteira que vai receber o USDC, na rede em que você cobra: Stellar, Solana ou Monad. Você o adiciona à sua organização no dashboard e comprova que ele é seu com uma assinatura. Os links de pagamento criados no dashboard só pagam para as carteiras adicionadas ali.

O que seu cliente precisa

Uma carteira na mesma rede, com o USDC, que consiga abrir o pagamento: na Stellar, qualquer carteira que abra links SEP-7; na Solana, qualquer carteira que leia links do Solana Pay; na Monad, qualquer carteira EVM que leia links EIP-681. A carteira dele também paga a taxa de rede.

Não precisa de conta. Ele abre o checkout, escaneia o QR code ou toca no botão da carteira e aprova o pagamento na própria carteira.

Três formas de cobrar

As três usam o mesmo checkout, o mesmo dashboard e os mesmos webhooks, então você pode começar com um link e passar para a API quando precisar.

  • Link de pagamento: crie no dashboard e envie por chat ou e-mail, ou mostre o QR code. Sem código.
  • Checkout hospedado: envie seu cliente para a página de pagamento do link, abra-a a partir de um botão de pagamento ou mostre-a dentro da sua página com uma única tag script.
  • API de pagamentos: crie cada pagamento no seu servidor com uma requisição, ou com o SDK em TypeScript, e desenhe sua própria tela de pagamento.

Aceite seu primeiro pagamento em USDC, passo a passo

  1. Crie sua conta e mude para Sandbox

    Entre no dashboard e escolha Sandbox no topo. O que você cria ali funciona nas redes de teste (Stellar Testnet, Solana Devnet e Monad Testnet) e não movimenta dinheiro real.

  2. Adicione a carteira que recebe o dinheiro

    Nas configurações da sua organização, adicione uma carteira na rede em que vai cobrar e assine o que o dashboard pedir: essa assinatura comprova que a carteira é sua.

  3. Crie uma cobrança de teste

    Em Pagamentos, crie um link de pagamento com a rede, o valor, o ativo e a carteira que o recebe. Ou crie uma chave de API de teste (começa com dv_) e chame POST /v1/payment-intents/pay do seu servidor. Na Stellar Testnet você pode cobrar em XLM, que o Friendbot, o faucet da Testnet, envia para uma conta de teste.

  4. Pague com uma carteira de teste

    Abra a página de pagamento: ela avisa que funciona numa rede de testes. Pague com uma carteira dessa rede e veja o checkout passar para Pago e o link para Concluído no dashboard.

  5. Confirme os pagamentos no seu servidor

    Adicione um endpoint de webhook no dashboard. Quando a rede confirma um pagamento, a Cosmos Pay envia PAYMENT_INTENT_SUCCEEDED, assinado com HMAC-SHA256. Entregue o pedido quando ele chegar, não quando a página do cliente disser que está pago.

  6. Mude para Produção

    Escolha Produção no dashboard e crie uma chave de API de produção (começa com prod_). As mesmas requisições passam a cobrar nas redes principais: a chave decide a rede, não o código.

Em qual rede cobrar

Cobre na rede em que seus clientes já têm USDC. O USDC é predefinido na Stellar e na Solana, tanto na mainnet quanto na rede de testes, e na mainnet da Monad. Nas três, qualquer outro token pode ser cobrado indicando o emissor, o mint ou o contrato.

Quanto custa

Cada pagamento paga a tarifa do seu plano, a mesma em todas as redes: 1.5% + 18¢ no Starter, sem mensalidade. A carteira de quem paga cobre a taxa de rede; na Monad, a taxa do repasse que leva o pagamento até você é descontada dele.

Perguntas e respostas.

Pagamentos por rede:Pagamentos na StellarPagamentos na SolanaPagamentos na Monad

Posso aceitar USDC sem escrever código?

Sim. Crie um link de pagamento no dashboard e compartilhe por chat ou e-mail, ou mostre o QR code. O status de cada pagamento aparece no dashboard.

Meu cliente paga em USDC e eu recebo USDC?

Sim. Seu cliente paga no ativo definido no link, e esse mesmo ativo chega ao seu endereço.

Posso testar sem dinheiro real?

Sim. No Sandbox e com chaves de teste (dv_), os links funcionam em redes de teste, e o checkout deles avisa que nenhum fundo real é movimentado.

Um cliente pode reverter um pagamento em USDC?

Não. Depois que a rede confirma um pagamento, ele é definitivo. Um reembolso é um novo pagamento que você envia da sua carteira.

Comece a aceitar stablecoins.

Crie uma conta grátis, gere uma chave de teste e envie hoje o seu primeiro link de pagamento.

Fale com a gente

Dúvidas sobre planos, integração ou pagamentos protegidos: conte para nós e respondemos por e-mail.

Usamos estes dados só para responder a você.