> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkout de Stablecoins

> Crie e gerencie links de pagamento de checkout para pagamentos em stablecoins sem fricção

<Note>
  Em resumo<br />
  O Blockradar Checkout permite aceitar pagamentos em stablecoins por meio de links compartilháveis, sem necessidade de contas de cliente ou integrações complexas. Crie um link, compartilhe e receba pagamentos diretamente em sua wallet.
</Note>

<iframe className="w-full h-[500px]" height="315" src="https://www.youtube.com/embed/nHCakfoSPWw?si=zar81as8HDK-HMrB" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

## Pré-requisitos

Antes de criar links de pagamento, certifique-se de ter:

<Steps>
  <Step title="Chave de API">
    Obtenha sua chave de API no [Dashboard do Blockradar](https://dashboard.blockradar.co). Acesse **Developers** para gerar uma.
  </Step>

  <Step title="Master Wallet criada">
    Crie uma master wallet por meio da [API Create Wallet](/en/api-reference/wallets/create-wallet) ou pelo dashboard. Os links de pagamento estão vinculados a uma wallet.
  </Step>

  <Step title="Plano de Checkout ativo">
    Garanta que o recurso de Checkout esteja habilitado em sua conta. Entre em contato com [support@blockradar.co](mailto:support@blockradar.co) se precisar ativá-lo.
  </Step>

  <Step title="Webhook configurado (opcional)">
    Configure webhooks para receber notificações de pagamento em tempo real. Consulte [Webhooks](/en/essentials/webhooks) para obter detalhes de configuração.
  </Step>
</Steps>

## Introdução

Links de pagamento são URLs compartilháveis que permitem que qualquer pessoa envie pagamentos em stablecoins para sua wallet. São perfeitos para:

* **E-commerce**: Enviar para clientes para compras de produtos
* **Faturamento**: Incluir em faturas por serviços prestados
* **Doações**: Compartilhar nas redes sociais ou em sites
* **Pagamentos em marketplace**: Facilitar transações peer-to-peer
* **Cobrança por assinatura**: Coleta de pagamentos recorrentes

## Como funcionam os links de pagamento

<CardGroup cols={2}>
  <Card title="Criação" icon="plus">
    Crie um link de pagamento com parâmetros específicos como valor, nome,
    descrição e limites de pagamento.
  </Card>

  <Card title="Compartilhamento" icon="share">
    Compartilhe a URL gerada com seus clientes por e-mail, mensagens ou
    incorpore-a em seu site.
  </Card>

  <Card title="Pagamento" icon="credit-card">
    Os clientes clicam no link, inserem seus dados de pagamento e concluem a
    transação.
  </Card>

  <Card title="Confirmação" icon="check">
    Você recebe notificações por webhook e pode acompanhar o status do pagamento em tempo real.
  </Card>
</CardGroup>

## Recursos dos links de pagamento

* **Parâmetros personalizáveis**: Defina valor, descrição, limites de pagamento e metadata
* **URLs compartilháveis**: Gere links de pagamento exclusivos para cada transação
* **Pré-preenchimento de cliente**: Pré-preencha os dados do cliente por meio de parâmetros de query na URL
* **Acompanhamento em tempo real**: Monitore o status do pagamento e receba notificações por webhook
* **Suporte multi-rede**: Aceite pagamentos em diferentes redes blockchain
* **Integração com auto-sweep**: Os fundos são automaticamente consolidados na master wallet

### **Suporte multi-ativo**

* **USDT, USDC, DAI, BUSD** em várias blockchains
* **Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Tron, Solana, Celo**
* Conversão e roteamento automáticos para uma experiência ideal do usuário

### **Configuração flexível**

* **Valores fixos** para produtos/serviços específicos
* **Valores variáveis** para doações ou pagamentos personalizados
* **Limites de pagamento** para garantir pagamentos pontuais
* **Metadata personalizada** para acompanhamento e analytics
* **Notificações por webhook** para atualizações em tempo real

### **Segurança e compliance**

* **Triagem AML** em todos os pagamentos recebidos
* **Validação e verificação de endereços**
* **Detecção e prevenção de fraudes**
* **Compliance regulatório** em diferentes jurisdições

## Fluxo de pagamento

### **1. Criação do link de pagamento**

Quando você cria um link de pagamento, o Blockradar retorna uma URL de pagamento exclusiva:

```json theme={null}
{
  "id": "pl_123456789",
  "name": "Product Purchase",
  "url": "https://pay.blockradar.co/payment-link-10012",
  "amount": "100.00",
  "currency": "USD",
  "active": true
}
```

### **2. Pré-preenchimento de cliente com parâmetros de query**

Você pode aprimorar a URL de pagamento com parâmetros de query para pré-preencher automaticamente os dados do cliente na página de pagamento:

```
https://pay.blockradar.co/payment-link-10012?name=Customer&email=customer@example.com&reference=ORDER123&amount=99.99&redirectUrl=https://yoursite.com/payment-success
```

**Parâmetros de query opcionais suportados:**

* `name` - Nome do cliente (aparece na página de pagamento)
* `email` - Endereço de e-mail do cliente
* `reference` - Referência personalizada que será incluída nas respostas da transação
* `amount` - Pré-preenche o valor do pagamento (substitui o valor padrão do link, se definido)
* `redirectUrl` - URL para redirecionamento após a conclusão do pagamento

### **3. Redirecionamento após o pagamento**

Quando um `redirectUrl` é fornecido, os clientes serão automaticamente redirecionados para a URL especificada após a conclusão do processamento do pagamento. A URL de redirecionamento incluirá os seguintes parâmetros de query:

**Parâmetros de query do redirecionamento:**

* `status` - Status do pagamento (`success`, `failed`, `pending`)
* `tx_reference` - ID de referência da transação
* `reference` - Sua referência personalizada (se fornecida)
* `slug` - Identificador do link de pagamento

**Exemplo de URL de redirecionamento:**

```
https://yoursite.com/payment-success?status=success&tx_reference=tx_abc123&reference=ORDER123&slug=payment-link-10012
```

<Note>
  O redirecionamento ocorre apenas após a conclusão do processamento do pagamento. Se nenhum
  `redirectUrl` for fornecido, os clientes verão a página padrão de conclusão
  de pagamento.
</Note>

### **4. Configuração do valor**

Os links de pagamento suportam dois modos de valor:

**Valor fixo (predefinido)**

* Quando você especifica um `amount` durante a criação, os clientes não podem modificar o valor do pagamento
* Ideal para produtos ou serviços específicos com preço definido
* Exemplo: Compra de produto por exatamente US\$ 99,99

**Valor variável (entrada do cliente)**

* Quando nenhum `amount` é especificado, os clientes podem inserir seu próprio valor de pagamento
* Perfeito para doações, gorjetas ou cenários de preços flexíveis
* Os clientes veem um campo de entrada de valor na página de pagamento

### **4. Processamento do pagamento**

Os clientes visitam o link de pagamento, revisam os detalhes pré-preenchidos e concluem a transação usando sua stablecoin preferida.

### **5. Resposta da transação**

O parâmetro `reference` da URL será incluído na resposta da transação e nos payloads dos webhooks, permitindo que você vincule os pagamentos aos seus sistemas internos.

## Experimente

Conheça os links de pagamento do Blockradar com nossa demonstração ao vivo:

**🔗 Link de pagamento de demonstração**: [https://pay.blockradar.co/demo](https://pay.blockradar.co/demo)

Esta demonstração apresenta:

* **Fluxo de pagamento**: Experiência completa do cliente, do link à conclusão
* **UI/UX**: Interface de pagamento moderna e intuitiva
* **Opções de stablecoins**: Vários métodos de pagamento e redes
* **Atualizações em tempo real**: Status e confirmações da transação ao vivo

<Note>
  O link de pagamento de demonstração é apenas para fins de teste. Nenhuma transação real
  será processada.
</Note>

## Criação de links de pagamento

### **Link de pagamento básico**

Crie um link de pagamento simples para um valor fixo:

```json theme={null}
{
  "name": "Product Purchase",
  "description": "Payment for Laptop Pro 2024",
  "amount": "100.00",
  "redirectUrl": "https://store.example.com/thank-you",
  "successMessage": "Thank you for your purchase!",
  "metadata": "{\"product_id\": \"prod_123\", \"order_id\": \"ord_456\"}"
}
```

### **Link de pagamento com valor variável**

Permita que os clientes escolham o valor do pagamento:

```json theme={null}
{
  "name": "Donation Campaign",
  "description": "Support our disaster relief efforts",
  "redirectUrl": "https://charity.example.com/thank-you",
  "successMessage": "Thank you for your generous donation!",
  "metadata": "{\"campaign\": \"disaster_relief_2024\"}"
}
```

### **Link de pagamento com upload de arquivo**

Inclua um arquivo (por exemplo, fatura, imagem do produto) com seu link de pagamento usando form-data:

**Campos do form-data:**

* `name`: Service Invoice
* `description`: Web development services - January 2024
* `amount`: 1500.00
* `redirectUrl`: [https://company.example.com/payment-success](https://company.example.com/payment-success)
* `successMessage`: Payment received! We'll start working on your project.
* `metadata`: invoice\_id: INV-2024-001, service: web\_development
* `file`: \[cover.png] (upload de arquivo)

<Note>
  Ao incluir uploads de arquivos, use form-data em vez de JSON. O arquivo será
  armazenado e ficará acessível pelo link de pagamento.
</Note>

## Parâmetros do link de pagamento

### **Parâmetros obrigatórios**

| Parâmetro | Tipo              | Descrição                   |
| --------- | ----------------- | --------------------------- |
| `name`    | string (máx: 250) | O nome do link de pagamento |

### **Parâmetros opcionais**

| Parâmetro         | Tipo                 | Descrição                                                                                                        |
| ----------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `description`     | string (máx: 250)    | Uma descrição do link de pagamento                                                                               |
| `slug`            | string (máx: 250)    | Um identificador único (URL-friendly). Deve corresponder à regex: `^[a-zA-Z0-9-]+$`                              |
| `amount`          | string               | O valor do link de pagamento. Deve ser uma string numérica válida > 0                                            |
| `redirectUrl`     | string (URL)         | A URL para redirecionar o usuário após o pagamento. Deve incluir http\:// ou https\://                           |
| `successMessage`  | string (máx: 500)    | Mensagem exibida quando o pagamento é bem-sucedido                                                               |
| `inactiveMessage` | string (máx: 500)    | Mensagem exibida quando o link de pagamento está inativo                                                         |
| `metadata`        | object (JSON string) | Metadata personalizada como pares chave-valor (string ou número). Deve ser enviada como JSON string em form-data |
| `paymentLimit`    | number (mín: 1)      | Número máximo de pagamentos permitidos para este link                                                            |
| `file`            | file                 | Upload de arquivo opcional (por exemplo, imagem ou documento) anexado ao link de pagamento                       |

## Fluxo de pagamento

### **Experiência do cliente**

1. **Clicar no link de pagamento**

   * O cliente recebe e clica no link de pagamento
   * O link abre uma página de pagamento segura

2. **Selecionar o método de pagamento**

   * Escolher entre as stablecoins disponíveis
   * Selecionar a rede blockchain preferida
   * Inserir o valor do pagamento (se variável)

3. **Concluir o pagamento**

   * O cliente confirma os detalhes da transação
   * O pagamento é processado na blockchain
   * Confirmação e atualizações de status em tempo real

4. **Confirmação de sucesso**
   * Página de confirmação de pagamento
   * Redirecionamento opcional para seu site
   * Recibo e detalhes da transação

### **Experiência do comerciante**

1. **Notificações em tempo real**

   * Eventos de webhook para o status do pagamento
   * Notificações por e-mail (se configuradas)
   * Atualizações no dashboard

2. **Acompanhamento de pagamentos**
   * Histórico e status de transações
   * Analytics e relatórios de pagamentos
   * Integração com seus sistemas

## Ciclo de vida do endereço

<Warning>
  Os endereços de pagamento gerados para links de checkout têm um ciclo de vida limitado:

  * **Após um pagamento bem-sucedido**: O endereço é desativado imediatamente e não pode receber pagamentos adicionais
  * **Após 24 horas de inatividade**: Se nenhum pagamento for feito a um endereço dentro de 24 horas, ele é automaticamente desativado

  Cada nova sessão de pagamento gera um novo endereço. Isso garante segurança e evita a reutilização de endereços.
</Warning>

## Eventos de webhook

Os links de pagamento disparam os seguintes eventos de webhook quando os pagamentos são recebidos:

| Evento            | Descrição                                     |
| ----------------- | --------------------------------------------- |
| `deposit.success` | Pagamento foi recebido pelo link de pagamento |
| `deposit.failed`  | A tentativa de pagamento falhou               |

### **Exemplo de payload de webhook**

```json theme={null}
{
  "event": "deposit.success",
  "data": {
    "id": "0d7a0b98-943c-48d0-8baa-216c29956050",
    "reference": "bjXPk7d00",
    "senderAddress": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
    "recipientAddress": "0x9D8dF15628B737CAf63a92Abd8E8bb304210eA94",
    "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1",
    "amountPaid": "1",
    "amountUSD": "1",
    "rateUSD": "1",
    "fee": null,
    "feeHash": null,
    "currency": "USD",
    "toCurrency": null,
    "blockNumber": 34771099,
    "blockHash": "0xa9dc060dbe649676a15ae1faee725851fe1ecf2401b200e60fff33fc0ff41e84",
    "hash": "0x9f01af8f517afb3fd3ee17f36dabee03a4d6514885473115815de86c28ea7dfb",
    "confirmations": 6,
    "confirmed": true,
    "gasPrice": "7026436",
    "gasUsed": "62159",
    "gasFee": "0.000000436756235324",
    "status": "SUCCESS",
    "type": "DEPOSIT",
    "note": null,
    "amlScreening": {
      "provider": "ofac, fbi, tether, circle",
      "status": "success",
      "message": "Address is not sanctioned"
    },
    "assetSwept": true,
    "assetSweptAt": "2025-08-27T21:53:22.300Z",
    "assetSweptGasFee": "0.000000489848406004",
    "assetSweptHash": "0xe85efcf15ff8eaa2429aea32515347d65ff8098f22dac567611c258441bde809",
    "assetSweptSenderAddress": "0x9D8dF15628B737CAf63a92Abd8E8bb304210eA94",
    "assetSweptRecipientAddress": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43",
    "assetSweptAmount": "1",
    "reason": "Funds swept successfully",
    "network": "mainnet",
    "chainId": 8453,
    "metadata": {},
    "toAmount": null,
    "signedTransaction": null,
    "rate": null,
    "createdAt": "2025-08-27T21:52:19.839Z",
    "updatedAt": "2025-08-27T21:53:22.303Z",
    "asset": {
      "id": "3a18a31a-86ad-44a0-9b9c-cdb69d535c64",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "standard": null,
      "currency": "USD",
      "isActive": true,
      "logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800083/crypto-assets/usd-coin-usdc-logo_fs9mhv.png",
      "network": "mainnet",
      "isNative": false,
      "createdAt": "2024-06-08T12:59:11.303Z",
      "updatedAt": "2025-06-03T11:34:36.288Z"
    },
    "address": {
      "id": "824d8ff9-1ee4-43d1-bec0-c77f25699cd6",
      "address": "0x9D8dF15628B737CAf63a92Abd8E8bb304210eA94",
      "name": null,
      "isActive": true,
      "type": "INTERNAL",
      "derivationPath": "m/44'/60'/0'/0/503",
      "metadata": null,
      "configurations": {
        "aml": {
          "status": "success",
          "message": "Address is not sanctioned",
          "provider": "ofac, fbi, tether, circle"
        }
      },
      "network": "mainnet",
      "createdAt": "2025-08-27T21:52:19.839Z",
      "updatedAt": "2025-08-27T21:52:19.839Z"
    },
    "blockchain": {
      "id": "28a730d3-211b-40f7-bb8f-dd589dcc738e",
      "name": "base",
      "symbol": "eth",
      "slug": "base",
      "derivationPath": "m/44'/60'/0'/0",
      "isEvmCompatible": true,
      "isL2": true,
      "logoUrl": "https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/Base_Network_Logo_vqyh7r.png",
      "isActive": true,
      "tokenStandard": null,
      "createdAt": "2024-06-07T11:09:56.586Z",
      "updatedAt": "2025-11-26T15:26:21.825Z"
    },
    "wallet": {
      "id": "6b741fbc-8a9c-48a1-92b0-ae7b52de8b9e",
      "name": "Base Mainnet Wallet",
      "description": "This is base mainnet wallet",
      "address": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43",
      "derivationPath": "m/44'/60'/0'/0/0",
      "isActive": true,
      "status": "ACTIVE",
      "network": "mainnet",
      "configurations": {
        "withdrawal": {
          "gasless": {
            "isActive": true
          }
        },
        "autoSweeping": {
          "isActive": true
        }
      },
      "createdAt": "2024-06-15T02:53:23.409Z",
      "updatedAt": "2025-08-18T23:26:13.469Z",
      "business": {
        "id": "a109729b-3b97-4fb3-a90a-769a0cbf6a25",
        "name": "Blockradar",
        "sector": "infrastructure",
        "userId": "831b739e-ed85-499a-b273-8a1a5b41b7a0",
        "status": "ACTIVE",
        "pipedriveOrganizationId": "308",
        "createdAt": "2023-04-28T17:40:18.541Z",
        "updatedAt": "2025-06-19T23:51:01.019Z"
      }
    },
    "beneficiary": null,
    "paymentLink": {
      "id": "dd8eb830-0971-4f61-97bc-b1ad352e1c48",
      "name": "Blockradar Checkout Demo",
      "description": "Blockradar payment links simplify stablecoin transactions into a clean, intuitive experience. This demo shows how users can pay securely using stablecoins with just a few clicks, fast, transparent, and onchain.",
      "slug": "demo",
      "amount": null,
      "currency": "USD",
      "imageUrl": "https://res.cloudinary.com/blockradar/image/upload/v1752049884/payment-links/ndlbgyb5wg70bpr3p1uu.png",
      "redirectUrl": null,
      "successMessage": null,
      "active": true,
      "inactiveMessage": null,
      "network": "mainnet",
      "type": "payment",
      "createdChannel": "dashboard",
      "metadata": {},
      "configurations": {},
      "createdAt": "2024-06-20T05:38:13.863Z",
      "updatedAt": "2025-07-09T08:31:25.328Z"
    },
    "toAsset": null,
    "toBlockchain": null,
    "toWallet": null
  }
}
```

### **Principais campos de dados do webhook**

O payload do webhook inclui informações abrangentes sobre o pagamento:

| Campo          | Descrição                                                                                      |
| -------------- | ---------------------------------------------------------------------------------------------- |
| `reference`    | Referência personalizada dos parâmetros de query da URL (por exemplo, ORDER123, ID do cliente) |
| `paymentLink`  | Detalhes completos do link de pagamento, incluindo nome, descrição e metadata                  |
| `asset`        | Informações do ativo (USDC, USDT, etc.) com detalhes da rede                                   |
| `blockchain`   | Informações da rede (Base, Ethereum, etc.)                                                     |
| `wallet`       | Detalhes e configurações da master wallet                                                      |
| `address`      | Endereço do cliente que recebeu o pagamento                                                    |
| `amlScreening` | Resultados da triagem de antilavagem de dinheiro                                               |
| `assetSwept`   | Status e detalhes do auto-sweep                                                                |
| `metadata`     | Dados personalizados do link de pagamento                                                      |

<Note>
  O campo `reference` nos payloads dos webhooks corresponde ao parâmetro de query `reference`
  que você inclui na URL de pagamento. Isso permite que você rastreie pagamentos
  até pedidos, clientes ou referências internas específicas em seu sistema.
</Note>

## Boas práticas

### **Segurança**

* **Use HTTPS** para compartilhar todos os links de pagamento
* **Monitore os eventos de webhook** em busca de atividade suspeita
* **Implemente rate limiting** em seus endpoints de webhook

### **Experiência do usuário**

* **Descrições claras** sobre a finalidade do pagamento
* **Páginas de pagamento otimizadas para mobile**
* **Múltiplas opções de pagamento** quando possível

### **Integração**

* **Armazene os IDs dos links de pagamento** para rastreamento
* **Use metadata** para vincular pagamentos aos seus sistemas
* **Implemente lógica de retry de webhooks** para maior confiabilidade
* **Teste os webhooks** primeiro no ambiente sandbox

## Casos de uso e exemplos

### **Loja de e-commerce**

```json theme={null}
{
  "name": "Laptop Pro 2024",
  "description": "High-performance laptop with latest specifications",
  "amount": "299.99",
  "redirectUrl": "https://store.example.com/thank-you",
  "successMessage": "Thank you for your purchase! Your order has been confirmed.",
  "metadata": "{\"product_id\": \"laptop_pro_2024\", \"category\": \"electronics\", \"customer_email\": \"customer@example.com\"}",
  "paymentLimit": 1
}
```

### **Fatura de serviço**

```json theme={null}
{
  "name": "Web Development Services",
  "description": "Professional web development services - January 2024",
  "amount": "1500.00",
  "redirectUrl": "https://company.example.com/payment-success",
  "successMessage": "Payment received! We'll start working on your project immediately.",
  "metadata": "{\"invoice_id\": \"INV-2024-001\", \"service\": \"web_development\", \"client_id\": \"client_789\"}",
  "paymentLimit": 1
}
```

### **Campanha de doação**

```json theme={null}
{
  "name": "Disaster Relief 2024",
  "description": "Support our disaster relief efforts in affected regions",
  "amount": "10.00",
  "redirectUrl": "https://charity.example.com/thank-you",
  "successMessage": "Thank you for your generous donation! Every contribution makes a difference.",
  "metadata": "{\"campaign\": \"disaster_relief_2024\", \"organization\": \"charity_foundation\", \"tax_deductible\": true}",
  "paymentLimit": 1000
}
```

### **Serviço por assinatura**

```json theme={null}
{
  "name": "Premium Plan Monthly",
  "description": "Monthly subscription to our premium service",
  "amount": "29.99",
  "redirectUrl": "https://service.example.com/welcome",
  "successMessage": "Welcome to Premium! Your subscription is now active.",
  "metadata": "{\"plan\": \"premium_monthly\", \"billing_cycle\": \"monthly\", \"features\": \"unlimited_access\"}",
  "paymentLimit": 100
}
```

<Note>
  Esses exemplos usam os parâmetros corretos da API de payment links do Blockradar. O
  campo `metadata` deve ser enviado como JSON string em form-data, e os uploads
  de `file` são suportados para conteúdo adicional.
</Note>

## Testes e desenvolvimento

### **Ambiente sandbox**

* Use redes de testnet para desenvolvimento
* Teste a entrega e o tratamento de webhooks
* Verifique os fluxos de pagamento de ponta a ponta
* Teste casos extremos e cenários de erro

### **Testes de webhook**

* Use ferramentas como [webhook.site](https://webhook.site) para testar
* Verifique a validação de assinaturas
* Teste os mecanismos de retry
* Monitore as taxas de entrega de webhooks

## Plano de Checkout

O **Blockradar Checkout** é uma camada programável de pagamento em stablecoins para aceitar pagamentos onchain via links, QR codes incorporados e WalletConnect. Os fundos são liquidados diretamente em suas wallets não custodiais com suporte integrado para swap, bridge e roteamento de tesouraria.

### **Preços**

<Card title="0,75% por transação" icon="percent">
  Preços simples e transparentes, sem custos de assinatura mensal.
</Card>

### **Stablecoins suportadas**

* **USDC, USDT, cNGN, IDRX, EUROC** e outras

### **Suporte multi-chain**

* **Ethereum, Polygon, Base, Solana, Tron, Celo** e outras

### **Gestão de tesouraria**

* **Swap e Bridge**: Converta e movimente ativos entre chains
* **Auto-liquidação**: Liquide automaticamente em sua moeda preferida
* **Circle Gateway**: Acesse o protocolo de transferência cross-chain da Circle
* **Auto-sweeping**: Consolide os fundos em sua master wallet

<Note>
  Este plano não inclui os recursos de Wallet-as-a-Service (WaaS) nem o
  provisionamento de wallets dedicadas para seus usuários finais.
</Note>

## Obtendo as transações de um link de pagamento

Você pode recuperar todas as transações associadas a um link de pagamento específico usando o endpoint de transações dedicado. Isso é útil para:

* **Acompanhamento de pagamentos**: Monitorar todos os pagamentos recebidos por um link específico
* **Reconciliação**: Combinar pagamentos a pedidos ou faturas
* **Relatórios**: Gerar relatórios para links de pagamento específicos

### **Parâmetros de query**

| Parâmetro | Tipo   | Descrição                                                               |
| --------- | ------ | ----------------------------------------------------------------------- |
| `page`    | number | Número da página para paginação (padrão: 1)                             |
| `limit`   | number | Número de resultados por página (padrão: 10)                            |
| `status`  | string | Filtrar por status da transação (por exemplo, SUCCESS, PENDING, FAILED) |
| `type`    | string | Filtrar por tipo de transação (por exemplo, DEPOSIT)                    |
| `order`   | string | Ordem de classificação (ASC ou DESC)                                    |

### **Exemplo de resposta**

```json theme={null}
{
  "status": true,
  "message": "Transactions fetched successfully",
  "data": [
    {
      "id": "0d7a0b98-943c-48d0-8baa-216c29956050",
      "reference": "bjXPk7d00",
      "amount": "100.00",
      "amountUSD": "100.00",
      "status": "SUCCESS",
      "type": "DEPOSIT",
      "createdAt": "2025-01-15T10:30:00.000Z",
      "asset": {
        "symbol": "USDC",
        "name": "USD Coin"
      },
      "blockchain": {
        "name": "base",
        "slug": "base"
      },
      "customer": {
        "email": "customer@example.com",
        "name": "John Doe"
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 25,
    "totalPages": 3
  }
}
```

## Suporte e recursos

### **Referência da API**

* [Criar link de pagamento](/en/api-reference/payment-links/create)
* [Obter todos os links de pagamento](/en/api-reference/payment-links/get-all)
* [Obter link de pagamento](/en/api-reference/payment-links/get-one)
* [Atualizar link de pagamento](/en/api-reference/payment-links/update)
* [Obter transações do link de pagamento](/en/api-reference/payment-links/get-transactions)

### **Obter ajuda**

* **E-mail**: [support@blockradar.co](mailto:support@blockradar.co)
* **Referência da API**: [Checkout](/en/api-reference/payment-links/create)

<Note>
  Checkout e links de pagamento são uma maneira poderosa de aceitar pagamentos em stablecoins com mínimo
  esforço de integração. Comece com casos de uso simples e adicione complexidade
  gradualmente, à medida que se familiariza com o sistema.
</Note>