Como aceitar USDC com links do Solana Pay

O que um link do Solana Pay contém

O Solana Pay é um padrão de solicitações de pagamento que as carteiras da Solana leem: um link solana:, ou o QR code dele, com o endereço a pagar, o valor, o token e uma mensagem.

A Cosmos Pay adiciona uma chave de referência criada para cada link. A carteira inclui essa chave na transação, e a Cosmos Pay procura por ela na Solana para associar o pagamento ao seu link. O pagamento só é aceito quando a transação foi bem-sucedida e o valor exato chegou ao seu endereço.

A especificação do Solana PayPagamentos na Solana

O que você e seu cliente precisam

• Você: um endereço da Solana que recebe o dinheiro, adicionado à sua organização no dashboard e comprovado como seu com uma assinatura.
• Seu cliente: uma carteira da Solana que leia links do Solana Pay, como Phantom ou Solflare, com o USDC e um pouco de SOL para a taxa de rede. Sem conta na Cosmos Pay.
• Para testes: o Sandbox, onde os links funcionam na Solana Devnet. O USDC também é predefinido ali, então você pode testar com USDC da Devnet.

Aceite seu primeiro pagamento com Solana Pay

1. Mude para Sandbox

   Entre no dashboard e escolha Sandbox no topo. Os links que você cria ali funcionam na Solana Devnet e não movimentam dinheiro real.

2. Adicione sua carteira da Solana

   Nas configurações da sua organização, adicione o endereço da Solana que vai receber o dinheiro e assine o que o dashboard pedir: essa assinatura comprova que a carteira é sua.

3. Crie o link

   Em Pagamentos, escolha Criar link de pagamento, selecione Solana e mude o ativo para USDC (o seletor começa em SOL). Informe o valor, ou deixe-o vazio para seu cliente escolher, depois escolha sua carteira e, se quiser, uma mensagem.

4. Pague com uma carteira

   Abra a página de pagamento e escaneie o QR code com uma carteira da Solana, ou abra o link no mesmo dispositivo. Aprove o pagamento na carteira, e o checkout passa para Pago assim que a Solana o confirma.

5. Confirme no seu servidor

   Adicione um endpoint de webhook no dashboard. Quando o pagamento é confirmado, a Cosmos Pay envia PAYMENT_INTENT_SUCCEEDED, assinado com HMAC-SHA256. Entregue o pedido quando ele chegar.

6. Mude para Produção

   Escolha Produção e crie uma chave de API de produção (começa com prod_). Os links passam a funcionar na rede principal da Solana, onde o USDC tem a sua própria predefinição.

Como confirmar um pagamento no seu servidorChaves de API

Crie o link no seu servidor

Com a API de pagamentos, chame POST /v1/payment-intents/pay com chain definido como solana, seu endereço como destino e, para USDC, o código de ativo USDC com o mint dele como emissor. Com o SDK em TypeScript (versão 2.2 ou posterior), passe chain: 'solana' para client.paymentIntents.createPay.

A resposta traz o link (o uri dele começa com solana:) e o QR code. Mostre o QR code, abra o link na carteira do seu cliente ou envie-o para o checkout hospedado: payments.cosmospay.lat seguido do id do link.

API de intenções de pagamentoIntenções de pagamento no SDK

Bom saber

• Você pode deixar o valor vazio para que seu cliente o escolha, como em doações. Um link que adiciona a sua própria taxa precisa de um valor.
• Uma mensagem de até 300 caracteres, como um número de pedido, aparece na carteira do seu cliente.
• Com a sua própria taxa no pagamento, o link vira uma solicitação de transação do Solana Pay que paga a sua carteira e a sua carteira de taxas numa única transação.
• Um link fica aberto por um tempo limitado, que o checkout mostra como contagem regressiva. Um pagamento que ainda chegue e seja confirmado marca o link como pago.
• A carteira do seu cliente paga a taxa de rede da Solana, em SOL. Cada pagamento paga a tarifa do seu plano, a mesma de todas as redes.

Preços e calculadora de tarifasStellar vs Solana vs Monad