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"
}
Criar assinatura recorrente
Plano com cobrança automática em ciclo fixo (semanal, mensal, etc.). Não é cobrança avulsa.
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
Chave wp_live_... criada em Integrações → Chaves de API no dashboard.
Body
application/json
Available options:
BOLETO, CARD_CREDIT, PIX Required range:
x >= 0.01Available options:
WEEKLY, BIWEEKLY, MONTHLY, BIMONTHLY, QUARTERLY, SEMIANNUALLY, YEARLY Show child attributes
Show child attributes
Token de cartão (cobranças seguintes)
Show child attributes
Show child attributes
Show child attributes
Show child attributes
IP do comprador (obrigatório em CARD_CREDIT)