Criar cobrança avulsa

curl -X POST 'https://api.wovepay.com/v1/billings/create' \
  -H 'X-API-Key: wp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "BOLETO",
    "amount": 79.9,
    "description": "Pedido 123",
    "dueDate": "2026-08-15",
    "externalReference": "pedido-123",
    "customer": {
      "name": "Cliente Exemplo",
      "taxId": "12345678909",
      "email": "cliente@exemplo.com"
    }
  }'

curl -X POST 'https://api.wovepay.com/v1/billings/create' \
  -H 'X-API-Key: wp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "CARD_DEBIT",
    "amount": 49.9,
    "description": "Pedido 456",
    "customer": {
      "name": "Cliente Exemplo",
      "taxId": "12345678909"
    }
  }'

{
  "success": true,
  "message": "Cobrança criada com sucesso",
  "data": {
    "id": "clx_billing",
    "status": "PENDING",
    "statusLabel": "Pendente",
    "method": "BOLETO",
    "amount": 79.9,
    "netAmount": 76.91,
    "feeAmount": 2.99,
    "notificationFeeAmount": 0,
    "installmentCount": 1,
    "description": "Pedido 123",
    "dueAt": "2026-08-15",
    "dueDate": "2026-08-15",
    "paidAt": null,
    "estimatedCreditDate": null,
    "invoiceUrl": "https://...",
    "bankSlipUrl": "https://...",
    "digitableLine": "23790...",
    "pixCopyPaste": null,
    "pixEncodedImage": null,
    "externalId": "pay_abc123",
    "externalReference": "pedido-123",
    "accountTransactionId": "clx_ledger",
    "createdAt": "2026-05-30T10:00:00.000Z",
    "customer": {
      "id": "12345678909",
      "name": "Cliente Exemplo",
      "taxId": "12345678909"
    }
  },
  "requestId": "req_abc123"
}

POST

billings

create

curl -X POST 'https://api.wovepay.com/v1/billings/create' \
  -H 'X-API-Key: wp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "BOLETO",
    "amount": 79.9,
    "description": "Pedido 123",
    "dueDate": "2026-08-15",
    "externalReference": "pedido-123",
    "customer": {
      "name": "Cliente Exemplo",
      "taxId": "12345678909",
      "email": "cliente@exemplo.com"
    }
  }'

curl -X POST 'https://api.wovepay.com/v1/billings/create' \
  -H 'X-API-Key: wp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "CARD_DEBIT",
    "amount": 49.9,
    "description": "Pedido 456",
    "customer": {
      "name": "Cliente Exemplo",
      "taxId": "12345678909"
    }
  }'

{
  "success": true,
  "message": "Cobrança criada com sucesso",
  "data": {
    "id": "clx_billing",
    "status": "PENDING",
    "statusLabel": "Pendente",
    "method": "BOLETO",
    "amount": 79.9,
    "netAmount": 76.91,
    "feeAmount": 2.99,
    "notificationFeeAmount": 0,
    "installmentCount": 1,
    "description": "Pedido 123",
    "dueAt": "2026-08-15",
    "dueDate": "2026-08-15",
    "paidAt": null,
    "estimatedCreditDate": null,
    "invoiceUrl": "https://...",
    "bankSlipUrl": "https://...",
    "digitableLine": "23790...",
    "pixCopyPaste": null,
    "pixEncodedImage": null,
    "externalId": "pay_abc123",
    "externalReference": "pedido-123",
    "accountTransactionId": "clx_ledger",
    "createdAt": "2026-05-30T10:00:00.000Z",
    "customer": {
      "id": "12345678909",
      "name": "Cliente Exemplo",
      "taxId": "12345678909"
    }
  },
  "requestId": "req_abc123"
}

curl -X POST 'https://api.wovepay.com/v1/billings/create' \
  -H 'X-API-Key: wp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "BOLETO",
    "amount": 79.9,
    "description": "Pedido 123",
    "dueDate": "2026-08-15",
    "externalReference": "pedido-123",
    "customer": {
      "name": "Cliente Exemplo",
      "taxId": "12345678909",
      "email": "cliente@exemplo.com"
    }
  }'

curl -X POST 'https://api.wovepay.com/v1/billings/create' \
  -H 'X-API-Key: wp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "CARD_DEBIT",
    "amount": 49.9,
    "description": "Pedido 456",
    "customer": {
      "name": "Cliente Exemplo",
      "taxId": "12345678909"
    }
  }'

{
  "success": true,
  "message": "Cobrança criada com sucesso",
  "data": {
    "id": "clx_billing",
    "status": "PENDING",
    "statusLabel": "Pendente",
    "method": "BOLETO",
    "amount": 79.9,
    "netAmount": 76.91,
    "feeAmount": 2.99,
    "notificationFeeAmount": 0,
    "installmentCount": 1,
    "description": "Pedido 123",
    "dueAt": "2026-08-15",
    "dueDate": "2026-08-15",
    "paidAt": null,
    "estimatedCreditDate": null,
    "invoiceUrl": "https://...",
    "bankSlipUrl": "https://...",
    "digitableLine": "23790...",
    "pixCopyPaste": null,
    "pixEncodedImage": null,
    "externalId": "pay_abc123",
    "externalReference": "pedido-123",
    "accountTransactionId": "clx_ledger",
    "createdAt": "2026-05-30T10:00:00.000Z",
    "customer": {
      "id": "12345678909",
      "name": "Cliente Exemplo",
      "taxId": "12345678909"
    }
  },
  "requestId": "req_abc123"
}

Corpo da requisição

string

required

BOLETO, CARD_CREDIT, CARD_DEBIT, CARD_VOUCHER ou PIX.

number

required

Valor em reais.

object

required

Pagador: name, taxId (CPF/CNPJ), email e phone opcionais, id opcional (referência interna).

string

Descrição exibida ao pagador.

string

YYYY-MM-DD (boleto; padrão +3 dias).

number

Parcelas 1–21 (CARD_CREDIT).

string

Token do cartão (CARD_CREDIT / CARD_VOUCHER).

object

Dados do cartão na primeira cobrança (CARD_CREDIT / CARD_VOUCHER).

object

Titular: name, email, cpfCnpj, postalCode, addressNumber, phone.

string

IP do comprador (CARD_CREDIT / CARD_VOUCHER). Se omitido, usa o IP da requisição.

string

ID do seu sistema (armazenado em data.externalReference).

Pagamento único. Para cobrança recorrente use POST /subscriptions/create.

Cartão de crédito (`CARD_CREDIT`)

Primeira cobrança com creditCard + creditCardHolderInfo + remoteIp, ou cardToken em cobranças seguintes. A resposta inclui data.creditCardToken para reutilização. Alternativa: POST /billings/tokenize-card.

Cartão de débito (`CARD_DEBIT`)

A Asaas não aceita captura transparente de débito. Crie a cobrança sem dados de cartão e redirecione o pagador para data.invoiceUrl.

Enviar creditCard, cardToken ou creditCardHolderInfo em CARD_DEBIT retorna 400.

Authorizations

X-API-Key

string

header

required

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

Body

application/json

method

enum<string>

required

CARD_DEBIT gera fatura hospedada (invoiceUrl); não envie dados de cartão. CARD_CREDIT e CARD_VOUCHER exigem cardToken ou creditCard + remoteIp.

Available options:

BOLETO,

CARD_CREDIT,

CARD_DEBIT,

CARD_VOUCHER,

PIX

amount

number

required

Required range: x >= 0.01

customer

object

required

Show child attributes

description

string

dueDate

string<date>

installmentCount

integer

Required range: 1 <= x <= 21

cardToken

string

Token do cartão para reutilização em cobranças futuras.

creditCard

object

Show child attributes

creditCardHolderInfo

object

Show child attributes

remoteIp

string

IP do comprador (CARD_CREDIT / CARD_VOUCHER).

authorizeOnly

boolean

externalReference

string

Response

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

Criar cobrança avulsa

Corpo da requisição

Cartão de crédito (`CARD_CREDIT`)

Cartão de débito (`CARD_DEBIT`)

Authorizations

Body

Response

​Corpo da requisição

​Cartão de crédito (CARD_CREDIT)

​Cartão de débito (CARD_DEBIT)

Authorizations

Body

Response

Corpo da requisição

Cartão de crédito (`CARD_CREDIT`)

Cartão de débito (`CARD_DEBIT`)