Listar cobranças avulsas

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"
}

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

X-API-Key

string

header

required

Chave wp_live_... criada em Integrações → Chaves de API no dashboard.

Query Parameters

page

integer

default:1

Required range: x >= 1

pageSize

integer

default:50

Required range: 1 <= x <= 100

dateFrom

string<date-time>

dateTo

string<date-time>

status

enum<string>

Available options:

PENDING,

PROCESSING,

CONFIRMED,

RECEIVED,

SETTLED,

OVERDUE,

CANCELED,

FAILED,

REFUNDED,

PARTIALLY_REFUNDED,

CHARGEBACK

method

enum<string>

Available options:

BOLETO,

CARD_CREDIT,

CARD_DEBIT,

CARD_VOUCHER,

PIX

billingType

enum<string>

Available options:

BOLETO,

CARD_CREDIT,

CARD_DEBIT,

CARD_VOUCHER,

PIX

salesCustomerId

string

externalReference

string

Response

200 - application/json

Operação concluída.

success

boolean

required

Example:

true

message

string

required

Example:

"Operação concluída com sucesso"

data

object

required

requestId

string

Introdução

Webhooks

WebSocket

PIX

Conta

Loja

Subcontas

Listar cobranças avulsas

Parâmetros de query

Authorizations

Query Parameters

Response

​Parâmetros de query

Authorizations

Query Parameters

Response

Parâmetros de query