Pular para o conteúdo principal
GET
/
charges
/
{id}
Buscar cobrança por ID
curl --request GET \
  --url https://api.pague.dev/v1/charges/{id} \
  --header 'X-API-Key: <x-api-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "Produto Premium",
  "currency": "BRL",
  "status": "active",
  "slug": "produto-premium-2024",
  "url": "https://pay.pague.dev/produto-premium-2024",
  "paymentMethods": [
    "pix",
    "credit_card"
  ],
  "maxInstallments": 6,
  "notifications": [
    "email"
  ],
  "allowCoupons": true,
  "paymentsCount": 5,
  "totalCollected": 495,
  "createdAt": "2023-11-07T05:31:56Z",
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": {},
  "amount": 99.9,
  "expiresAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Cabeçalhos

​
X-API-Key
string
obrigatório

Chave de API de integração (pd_live_* para produção, pd_test_* para sandbox)

Parâmetros de caminho

​
id
string<uuid>
obrigatório

ID da cobrança

Resposta

Detalhes da cobrança

​
id
string<uuid>
obrigatório

ID da cobrança

​
projectId
string<uuid>
obrigatório

ID do projeto

​
name
string
obrigatório

Nome da cobrança

Exemplo:

"Produto Premium"

​
currency
string
obrigatório

Código da moeda

Exemplo:

"BRL"

​
status
enum<string>
obrigatório

Status da cobrança

Opções disponíveis:
active,
expired,
disabled,
paid
​
slug
string
obrigatório

Slug da URL

Exemplo:

"produto-premium-2024"

​
url
string
obrigatório

URL completa do link de pagamento

Exemplo:

"https://pay.pague.dev/produto-premium-2024"

​
paymentMethods
string[]
obrigatório

Métodos de pagamento aceitos

Exemplo:
["pix", "credit_card"]
​
maxInstallments
integer
obrigatório

Número máximo de parcelas para cartão de crédito

Exemplo:

6

​
notifications
string[]
obrigatório

Canais de notificação

Exemplo:
["email"]
​
allowCoupons
boolean
obrigatório

Permitir cupons de desconto

​
paymentsCount
integer
obrigatório

Número de pagamentos recebidos

Exemplo:

5

​
totalCollected
number
obrigatório

Valor total arrecadado em BRL

Exemplo:

495

​
createdAt
string<date-time>
obrigatório

Data de criação

​
customerId
string<uuid>

ID do cliente (se pré-atribuído)

​
description
object

Descrição da cobrança

​
amount
number

Valor em BRL (null para valor aberto). Exemplo: 99.90 para R$ 99,90

Exemplo:

99.9

​
expiresAt
string<date-time>

Data de expiração

​
updatedAt
string<date-time>

Data de atualização