# Checkout cripto, botão de pagamento e API | Cosmos Pay

URL: https://payments.cosmospay.lat/integrations?lang=pt

> De um link de pagamento sem código até sua própria tela de pagamento com a API. Escolha como cobra e como o pagamento aparece no seu site.

## Pagamentos em stablecoins no seu site

De um link de pagamento sem código até sua própria tela de pagamento com a API. Escolha como cobra e como o pagamento aparece no seu site.

### Coloque o pagamento onde ele se encaixa no seu site.

Envie seus clientes para o nosso checkout, abra-o a partir de um botão, mostre-o dentro da sua página ou monte o seu com a API. Experimente cada opção abaixo: todas as demos funcionam nesta página, com dados de exemplo que não podem ser pagos.

#### Botão de pagamento (Uma linha de HTML)

Nosso script desenha um botão que abre o checkout numa janela sobre a sua página e avisa a sua página quando o pagamento é confirmado.

```html
<script defer
  src="https://payments.cosmospay.lat/embed/cosmos-pay.js"></script>

<!-- link: your payment link's id, from the dashboard or the API -->
<cosmos-pay-button
  link="cmh9a1q7r0000l208x9k4d1pz">
</cosmos-pay-button>

<script>
  document.querySelector("cosmos-pay-button")
    .addEventListener("cosmospay:paid", showThanks);
</script>
```

[Ler o guia do embed](https://dev.cosmospay.lat/docs/embed/)

#### Checkout incorporado (Uma linha de HTML)

O checkout fica dentro da sua página: valor, QR code e botão da carteira, com o status atualizando ao vivo e eventos que a sua página pode ouvir.

```html
<script defer
  src="https://payments.cosmospay.lat/embed/cosmos-pay.js"></script>

<!-- link: your payment link's id, from the dashboard or the API -->
<cosmos-pay-checkout
  link="cmh9a1q7r0000l208x9k4d1pz"
  lang="pt" theme="auto">
</cosmos-pay-checkout>

<script>
  document.querySelector("cosmos-pay-checkout")
    .addEventListener("cosmospay:status", (event) => {
      console.log(event.detail.status); // PENDING, SUBMITTED, SUCCEEDED
    });
</script>
```

[Ler o guia do embed](https://dev.cosmospay.lat/docs/embed/)

#### Checkout hospedado (Sem código no seu site)

Envie seu cliente para uma página de pagamento hospedada por nós. Escolha um de quatro designs por link; nenhum outro site pode incorporar a página.

Design do checkout:

- **Clássico**: Uma coluna limpa: valor, status ao vivo, código QR e os detalhes do pagamento.
- **Dividido**: Formas de pagamento num painel lateral com contagem regressiva. Quem paga escolhe como.
- **Recibo**: Dados do pagamento com um recibo ao lado: detalhes, linha de corte e o total.
- **Cartão**: Contagem regressiva grande, campos com rótulo e um cartão de pagamento com o código QR.

```html
<!-- Send your customer to the hosted checkout. Its design
     (classic, split, ticket or card) is set on the link,
     in the dashboard or with the API (checkoutTheme). -->
<a href="https://payments.cosmospay.lat/cmh9a1q7r0000l208x9k4d1pz">
  Pay with Cosmos Pay
</a>
```

[Criar um link de pagamento](https://dev.cosmospay.lat/login?next=%2Fdashboard%3Fview%3Dpayments)

#### Links de pagamento e QR (Sem código)

Crie um link no dashboard e compartilhe por chat, e-mail ou um QR code impresso. Seu cliente abre e paga pela carteira.

[Criar um link de pagamento](https://dev.cosmospay.lat/login?next=%2Fdashboard%3Fview%3Dpayments)

#### API e SDK (Sua própria interface)

Crie intents de pagamento no seu servidor, desenhe sua própria tela de pagamento e receba o resultado por webhooks assinados.

```ts
import { Client } from "@cosmosapp/pay_sdk";

const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });
const intent = await client.paymentIntents.createPay({
  destination: "G…YOUR_ACCOUNT",
  amount: "25",
});
// send your customer to the hosted checkout
const checkoutUrl = "https://payments.cosmospay.lat/" + intent.id;
```

[Ler a referência da API](https://dev.cosmospay.lat/docs/api/)

#### Plugins de e-commerce (Em breve)

Plugins para WooCommerce e Shopify, para receber na sua loja sem escrever código.

[Conte qual loja você usa](https://payments.cosmospay.lat/integrations?lang=pt#contact)

Seja qual for a opção, confirme o pagamento no seu servidor pelo webhook ou pela API.

### Poucas linhas de código.

Crie o pagamento no seu servidor, compartilhe o link do checkout e deixe o webhook avisar quando ele for pago.

- Uma API REST documentada com OpenAPI
- Um SDK em TypeScript: @cosmosapp/pay_sdk
- Webhooks assinados com HMAC-SHA256
- Chaves de teste (dv_) e chaves live (prod_)

- [Ler a documentação](https://dev.cosmospay.lat/docs/)
- [Referência da API](https://dev.cosmospay.lat/docs/api/)

#### REST

```bash
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_ACCOUNT",
    "amount": "25",
    "assetCode": "USDC",
    "assetIssuer": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
    "msg": "Order #1001",
    "checkoutTheme": "ticket"
  }'
```

#### SDK em TypeScript

```ts
import { Client } from "@cosmosapp/pay_sdk";

const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });
const intent = await client.paymentIntents.createPay({
  destination: "G…YOUR_ACCOUNT",
  amount: "25",
});
// send your customer to the hosted checkout
const checkoutUrl = "https://payments.cosmospay.lat/" + intent.id;
```

#### Webhook

```json
{
  "id": "evt_01JB…",
  "type": "PAYMENT_INTENT_SUCCEEDED",
  "createdAt": "2026-10-24T22:36:56.000Z",
  "data": {
    "id": "cmh9a1…",
    "status": "SUCCEEDED",
    "amount": "25",
    "txHash": "6864…2e54"
  }
}
```

O id da resposta é o link: https://payments.cosmospay.lat/<id>

### Três formas de começar a receber.

Comece hoje com um link e passe para a API quando precisar. Todas usam o mesmo checkout, o mesmo dashboard e os mesmos webhooks.

#### Links de pagamento (Sem código)

Crie um link no dashboard e compartilhe por chat, e-mail ou código QR.

- Um valor fixo, ou um que quem paga escolhe
- Uma mensagem que quem paga vê na carteira
- O status ao vivo no dashboard

[Criar um link de pagamento](https://dev.cosmospay.lat/login?next=%2Fdashboard%3Fview%3Dpayments)

#### Checkout hospedado (Pouco código)

Envie seus clientes para um checkout hospedado por nós, com o código QR, os botões de carteira e o status ao vivo.

- Quatro designs prontos
- Em português, inglês, espanhol, francês, alemão, hindi e chinês
- Páginas que nenhum outro site pode incorporar

[Ver as opções de integração](https://payments.cosmospay.lat/integrations?lang=pt)

#### API de pagamentos (Controle total)

Crie intents de pagamento no seu servidor e receba o resultado por webhooks assinados.

- REST, documentada com OpenAPI
- Um SDK em TypeScript
- Webhooks assinados com HMAC-SHA256

[Ler a documentação](https://dev.cosmospay.lat/docs/)

### Guias relacionados

[Ver todos os guias](https://payments.cosmospay.lat/learn?lang=pt)

#### [Como adicionar um botão de pagamento cripto ou um checkout ao seu site](https://payments.cosmospay.lat/learn/crypto-payment-button?lang=pt)

Carregue um script, adicione um botão de pagamento ou um checkout incorporado para um link de pagamento e confirme o pagamento no seu servidor.

#### [Como aceitar pagamentos em USDC online](https://payments.cosmospay.lat/learn/accept-usdc-payments?lang=pt)

Cobre em USDC com um link de pagamento, o checkout hospedado ou a API, e experimente antes numa rede de testes.

#### [Como enviar um link de pagamento no WhatsApp](https://payments.cosmospay.lat/learn/whatsapp-payment-links?lang=pt)

Crie um link no dashboard, envie numa conversa ou imprima o QR code, e veja quando ele é pago.

### Comece a aceitar stablecoins.

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

[Criar um link de pagamento](https://dev.cosmospay.lat/login?next=%2Fdashboard%3Fview%3Dpayments)

#### Fale com a gente

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

[organization@cosmospay.lat](mailto:organization@cosmospay.lat)