Aceite pagamentos na Stellar
A Cosmos Pay transforma cada pagamento em um link SEP-7 com QR code. Seu cliente paga com a carteira Stellar e o dinheiro vai direto ao seu endereço.

Como funciona um pagamento na Stellar
- Link de pagamento
- Links SEP-7 (web+stellar:pay) com QR code. Um pagamento de uma conta conhecida pode levar uma transação preparada no lugar (web+stellar:tx).
- Carteiras que pagam
- Qualquer carteira que abra links SEP-7. O checkout hospedado também pode abrir o pagamento na extensão da Cosmos Pay Wallet ou na carteira web dela.
- Cosmos Pay Wallet
Freighter
LOBSTR
xBull
Albedo
Rabet
- Como é identificado
- O memo do link, um MEMO_ID numérico. A carteira que abre o link o adiciona; um pagamento enviado manualmente também precisa dele.
- Para onde vai o dinheiro
- Direto para o seu endereço Stellar assim que a rede confirma o pagamento: cerca de 5 segundos.
- Rede de testes
- Stellar Testnet com uma chave de teste (dv_); a rede pública com uma chave de produção (prod_).
Ativos predefinidos
O dashboard oferece estes pelo nome. Qualquer outro ativo da Stellar é indicado pelo código e pelo emissor.
| Ativo | Emissor | Ambiente |
|---|---|---|
| XLM | A moeda própria da rede | Mainnet |
| USDCCircle | GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN | Mainnet |
| USDT0Tether | GATISXX6BZ6NC7IKQBY37CJD4SOZL3CYZJWXEDG6JVIY4WBS6KXJHN6Q | Mainnet |
| EURCCircle | GDHU6WRG4IEQXM5NZ4BMPKOXHW76MZM4Y2IEMFDVXBSDP6SJY4ITNPP2 | Mainnet |
| XLM | A moeda própria da rede | Testnet |
| USDCCircle | GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5 | Testnet |
| USDBBlindPay | GCQSSIMOW5OCGULZATDXKU5MOJBOMFX6G65X6CXZDQ7AIB3SKFUZ67NX | Testnet |
Quanto custa
Cada pagamento paga a tarifa do seu plano. A carteira de quem paga cobre a taxa de rede da Stellar.
- Starter1.5% + 18¢por pagamento0.65% por swapSem mensalidade
- Essentials1.12% + 18¢por pagamento0.26% por swap$33 por mês
- Growth0.75% + 18¢por pagamento0.13% por swap$99 por mês
- EnterpriseSob medida0.07% por swap
Crie um link de pagamento na Stellar
Uma requisição à Payments API com sua chave secreta. A resposta traz o link de pagamento (uri), o QR code e o id do checkout hospedado.
curl https://api.cosmospay.lat/cosmos-api/v1/payment-intents/pay \ -H "Authorization: Bearer $COSMOS_PAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "chain": "stellar", "destination": "G…YOUR_STELLAR_ACCOUNT", "amount": "25", "assetCode": "USDC", "assetIssuer": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN", "msg": "Order #1001" }'Uma chave de teste (dv_) cria o link na Testnet: use o emissor de USDC da Testnet da tabela acima, ou omita assetCode e assetIssuer para cobrar em XLM.
Quais carteiras podem pagar um link de pagamento na Stellar?
Qualquer carteira que abra links SEP-7, como Freighter, xBull, Rabet, LOBSTR, Albedo ou Cosmos Pay Wallet, pode pagar um link de pagamento da Cosmos Pay na Stellar. O checkout hospedado também pode abrir o pagamento na extensão da Cosmos Pay Wallet ou na carteira web dela, e no computador o cliente pode escanear o QR code com uma carteira no celular. Seu cliente não precisa de conta: a carteira dele paga a taxa de rede da Stellar, e o dinheiro vai direto para o seu endereço Stellar.
Por que um pagamento na Stellar leva um memo?
A Cosmos Pay associa cada pagamento na Stellar ao seu link de pagamento pelo memo do link, um MEMO_ID numérico. A carteira que abre o link SEP-7, com um toque ou pelo QR code, adiciona o memo sozinha. Um pagamento enviado manualmente precisa do mesmo memo: sem ele, a Cosmos Pay não consegue associar o pagamento ao link. Quando a rede confirma um pagamento com o memo certo, cerca de 5 segundos na Stellar, o checkout passa para Pago e o seu webhook é disparado.
Posso cobrar em USDC ou EURC na Stellar?
Sim. Na rede pública da Stellar, a Cosmos Pay oferece pelo nome o USDC e o EURC da Circle, junto com XLM e o USDT0 da Tether, e o USDC também é predefinido na Stellar Testnet. Qualquer outro ativo da Stellar é indicado pelo código e pelo emissor ao criar o link. Seu cliente paga no ativo do link, e esse mesmo ativo chega ao seu endereço Stellar assim que a rede confirma o pagamento: cerca de 5 segundos.
Como testo pagamentos na Stellar sem dinheiro real?
Crie uma chave de API de teste (dv_) no dashboard da Cosmos Pay, ou escolha Sandbox ali: os links de pagamento passam a funcionar na Stellar Testnet, e o checkout avisa que nenhum fundo real é movimentado. Cobre em USDC da Testnet com o emissor predefinido, ou em XLM, que o Friendbot, o faucet da Testnet, envia para uma conta de teste. Depois, uma chave de produção (prod_) cria os mesmos links na rede pública da Stellar: a chave decide a rede, não o código.
Posso adicionar minha própria taxa a um pagamento na Stellar?
Sim. A Cosmos Pay pode adicionar a sua própria taxa a um pagamento na Stellar, paga à carteira de taxas que você escolher; ela é separada da tarifa do seu plano, que cada pagamento continua pagando. Um link de pagamento SEP-7 paga uma única conta, então um link com a sua taxa pede a conta Stellar de quem paga e monta uma única transação preparada (web+stellar:tx) que paga você e a sua carteira de taxas ao mesmo tempo. Quem paga aprova essa única transação na carteira.
O valor de um pagamento na Stellar pode ficar privado?
Sim, com os pagamentos privados da Cosmos Pay: a rede verifica uma prova de conhecimento zero em vez de ler o valor, então o valor fica privado na blockchain. Eles funcionam na Stellar, sobre o token confidencial da OpenZeppelin para Stellar, e por enquanto na Testnet; os pagamentos na Solana e na Monad não os oferecem. Um pagamento privado custa 0.18% por transação, o mesmo em todos os planos.
Comece a aceitar stablecoins.
Crie uma conta grátis, gere uma chave de teste e envie hoje o seu primeiro link de pagamento.