Criar assinatura recorrente

curl -X POST 'https://api.wovepay.com/v1/subscriptions/create' \
  -H 'X-API-Key: wp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "BOLETO",
    "amount": 99.9,
    "cycle": "MONTHLY",
    "nextDueDate": "2026-08-01",
    "description": "Plano Premium",
    "customer": {
      "name": "Maria Silva",
      "taxId": "12345678909",
      "email": "maria@exemplo.com"
    }
  }'

{
  "success": true,
  "message": "Assinatura criada com sucesso",
  "data": {
    "subscriptionId": "sub_abc123",
    "externalId": "sub_ext_xyz",
    "status": "ACTIVE",
    "method": "BOLETO",
    "amount": 99.9,
    "cycle": "MONTHLY",
    "description": "Plano Premium",
    "nextDueDate": "2026-08-01",
    "createdAt": "2026-07-01T12:00:00.000Z",
    "customer": {
      "id": "12345678909",
      "name": "Maria Silva",
      "taxId": "12345678909"
    }
  },
  "requestId": "req_abc123"
}

POST

subscriptions

create

curl -X POST 'https://api.wovepay.com/v1/subscriptions/create' \
  -H 'X-API-Key: wp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "BOLETO",
    "amount": 99.9,
    "cycle": "MONTHLY",
    "nextDueDate": "2026-08-01",
    "description": "Plano Premium",
    "customer": {
      "name": "Maria Silva",
      "taxId": "12345678909",
      "email": "maria@exemplo.com"
    }
  }'

{
  "success": true,
  "message": "Assinatura criada com sucesso",
  "data": {
    "subscriptionId": "sub_abc123",
    "externalId": "sub_ext_xyz",
    "status": "ACTIVE",
    "method": "BOLETO",
    "amount": 99.9,
    "cycle": "MONTHLY",
    "description": "Plano Premium",
    "nextDueDate": "2026-08-01",
    "createdAt": "2026-07-01T12:00:00.000Z",
    "customer": {
      "id": "12345678909",
      "name": "Maria Silva",
      "taxId": "12345678909"
    }
  },
  "requestId": "req_abc123"
}

curl -X POST 'https://api.wovepay.com/v1/subscriptions/create' \
  -H 'X-API-Key: wp_live_SUA_CHAVE' \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "BOLETO",
    "amount": 99.9,
    "cycle": "MONTHLY",
    "nextDueDate": "2026-08-01",
    "description": "Plano Premium",
    "customer": {
      "name": "Maria Silva",
      "taxId": "12345678909",
      "email": "maria@exemplo.com"
    }
  }'

{
  "success": true,
  "message": "Assinatura criada com sucesso",
  "data": {
    "subscriptionId": "sub_abc123",
    "externalId": "sub_ext_xyz",
    "status": "ACTIVE",
    "method": "BOLETO",
    "amount": 99.9,
    "cycle": "MONTHLY",
    "description": "Plano Premium",
    "nextDueDate": "2026-08-01",
    "createdAt": "2026-07-01T12:00:00.000Z",
    "customer": {
      "id": "12345678909",
      "name": "Maria Silva",
      "taxId": "12345678909"
    }
  },
  "requestId": "req_abc123"
}

Corpo da requisição

string

required

BOLETO, CARD_CREDIT ou PIX.

number

required

Valor de cada ciclo em reais.

object

required

Pagador: name, taxId, email e phone opcionais, id opcional.

string

required

WEEKLY, BIWEEKLY, MONTHLY, BIMONTHLY, QUARTERLY, SEMIANNUALLY ou YEARLY.

string

required

Primeiro vencimento (YYYY-MM-DD).

string

Descrição da assinatura.

string

Token do cartão quando method é CARD_CREDIT.

object

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

object

Titular do cartão (obrigatório com creditCard).

string

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

Recorrência com ciclo fixo. Para pagamento único use POST /billings/create. CARD_DEBIT e voucher não são suportados em assinaturas.

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

Available options:

BOLETO,

CARD_CREDIT,

PIX

amount

number

required

Required range: x >= 0.01

cycle

enum<string>

required

Available options:

WEEKLY,

BIWEEKLY,

MONTHLY,

BIMONTHLY,

QUARTERLY,

SEMIANNUALLY,

YEARLY

nextDueDate

string<date>

required

customer

object

required

Show child attributes

description

string

cardToken

string

Token de cartão (cobranças seguintes)

creditCard

object

Show child attributes

creditCardHolderInfo

object

Show child attributes

remoteIp

string

IP do comprador (obrigatório em CARD_CREDIT)

authorizeOnly

boolean

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 assinatura recorrente

Corpo da requisição

Authorizations

Body

Response

​Corpo da requisição

Authorizations

Body

Response

Corpo da requisição