Skip to main content
POST
/
api
/
v1
/
subscriptions
/
{subscription}
/
charge
Cobrar Assinatura
curl --request POST \
  --url https://zeus-sandbox.autorizou.dev/api/v1/subscriptions/{subscription}/charge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "billing_date": "<string>",
  "amount": 123,
  "payment_reference": "<string>"
}
'
Cria uma cobrança pontual para uma assinatura já existente, usando o meio de pagamento associado a ela. Útil para agendar uma parcela extra, regularizar uma cobrança ou disparar manualmente o próximo ciclo em uma data específica.

​
Parâmetros da Requisição

​
subscription
string
required
UUID da assinatura que será cobrada.
​
billing_date
string
required
Data de cobrança no formato Y-m-d. Deve ser posterior a amanhã.Exemplo: 2026-07-01
​
amount
integer
required
Valor da cobrança em centavos. Mínimo: 1.Exemplo: 9990 (R$ 99,90)
​
payment_reference
string
required
Referência única desta cobrança no seu sistema.Máximo: 255 caracteres

​
Exemplos de Requisição

curl -X POST https://zeus-sandbox.autorizou.dev/api/v1/subscriptions/295e3b31-1684-4355-8ee5-4bbf7b97589b/charge \
    -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
    -H "Content-Type: application/json" \
    -d '{
        "billing_date": "2026-07-01",
        "amount": 9990,
        "payment_reference": "SUB-2026-07-001"
    }'

​
Exemplo de Resposta

{
  "id": "a1b2c3d4-1684-4355-8ee5-4bbf7b97589b",
  "subscription_id": "295e3b31-1684-4355-8ee5-4bbf7b97589b",
  "status": "scheduled",
  "amount": 9990,
  "billing_date": "2026-07-01",
  "payment_reference": "SUB-2026-07-001"
}

​
Códigos de Erro

Dados inválidos — por exemplo, billing_date não posterior a amanhã ou amount menor que 1.
{
    "message": "The billing date must be a date after tomorrow.",
    "errors": {
        "billing_date": ["The billing date must be a date after tomorrow."]
    }
}