curl -X GET 'https://api.wovepay.com/v1/billings/list?page=1&pageSize=50&method=PIX' \
-H 'X-API-Key: wp_live_SUA_CHAVE'
{
"success": true,
"message": "Cobranças listadas",
"data": {
"items": [{
"id": "clx_billing",
"status": "RECEIVED",
"statusLabel": "Pago",
"method": "PIX",
"amount": 79.9,
"netAmount": 76.91,
"feeAmount": 2.99,
"description": "Pedido 123",
"dueDate": "2026-06-15",
"externalId": "pay_abc123",
"externalReference": "pedido-123",
"createdAt": "2026-05-30T10:00:00.000Z",
"customer": {
"id": "clx_customer",
"name": "Cliente Exemplo",
"taxId": "12345678909"
}
}],
"page": 1,
"pageSize": 50,
"total": 1,
"pages": 1
},
"requestId": "req_abc"
}
Listar cobranças avulsas
Lista com paginação e filtros.
GET
/
billings
/
list
curl -X GET 'https://api.wovepay.com/v1/billings/list?page=1&pageSize=50&method=PIX' \
-H 'X-API-Key: wp_live_SUA_CHAVE'
{
"success": true,
"message": "Cobranças listadas",
"data": {
"items": [{
"id": "clx_billing",
"status": "RECEIVED",
"statusLabel": "Pago",
"method": "PIX",
"amount": 79.9,
"netAmount": 76.91,
"feeAmount": 2.99,
"description": "Pedido 123",
"dueDate": "2026-06-15",
"externalId": "pay_abc123",
"externalReference": "pedido-123",
"createdAt": "2026-05-30T10:00:00.000Z",
"customer": {
"id": "clx_customer",
"name": "Cliente Exemplo",
"taxId": "12345678909"
}
}],
"page": 1,
"pageSize": 50,
"total": 1,
"pages": 1
},
"requestId": "req_abc"
}
curl -X GET 'https://api.wovepay.com/v1/billings/list?page=1&pageSize=50&method=PIX' \
-H 'X-API-Key: wp_live_SUA_CHAVE'
{
"success": true,
"message": "Cobranças listadas",
"data": {
"items": [{
"id": "clx_billing",
"status": "RECEIVED",
"statusLabel": "Pago",
"method": "PIX",
"amount": 79.9,
"netAmount": 76.91,
"feeAmount": 2.99,
"description": "Pedido 123",
"dueDate": "2026-06-15",
"externalId": "pay_abc123",
"externalReference": "pedido-123",
"createdAt": "2026-05-30T10:00:00.000Z",
"customer": {
"id": "clx_customer",
"name": "Cliente Exemplo",
"taxId": "12345678909"
}
}],
"page": 1,
"pageSize": 50,
"total": 1,
"pages": 1
},
"requestId": "req_abc"
}
Parâmetros de query
number
Página (padrão 1).
number
Itens por página (padrão 50, máx. 100).
string
ISO 8601 — início (
createdAt).string
ISO 8601 — fim (
createdAt).string
PENDING, CONFIRMED, RECEIVED, OVERDUE, CANCELED, REFUNDED, FAILED, etc.string
BOLETO, CARD_CREDIT, CARD_DEBIT, CARD_VOUCHER ou PIX.string
Alias de
method (mesmos valores).string
Filtrar por cliente cadastrado.
string
Referência externa informada no create.
string
Busca em
id, externalReference, externalId (pay_...) ou descrição.Authorizations
Chave wp_live_... criada em Integrações → Chaves de API no dashboard.
Query Parameters
Required range:
x >= 1Required range:
1 <= x <= 100Available options:
PENDING, PROCESSING, CONFIRMED, RECEIVED, SETTLED, OVERDUE, CANCELED, FAILED, REFUNDED, PARTIALLY_REFUNDED, CHARGEBACK Available options:
BOLETO, CARD_CREDIT, CARD_DEBIT, CARD_VOUCHER, PIX Available options:
BOLETO, CARD_CREDIT, CARD_DEBIT, CARD_VOUCHER, PIX