Adicionar uma cobrança adicional
Permite ao produtor adicionar cobranças a um contrato já existente do cliente, que serão cobradas junto com a próxima fatura a ser paga
Required scopes:myeduzz_subscriptions_write
POST
https://api.eduzz.com/myeduzz/v1/subscriptions/additional-charges
Atenção
Este endpoint está disponível apenas para produtores no módulo beta. Entre em contato com o suporte para ativar o módulo beta.
Body params
subscriptionIdRequired
string
ID da assinatura
originKeyRequired
string
Seu ID da transação
referenceDateRequired
string
Data de referência da cobrança adicional
paymentStatusCallbackUrlRequired
string
URL de callback para status do pagamento
contentIdRequired
string
ID do conteúdo
priceRequired
object
Valor da cobrança adicional
price.currencyRequired
string
Moeda
price.valueRequired
number
Valor
descriptionRequired
string
Descrição da cobrança adicional
Response params (200)
id
string
ID da cobrança adicional
originKey
string
Chave de origem da transação
subscriptionId
string
ID da assinatura
status
enum
Status da cobrança adicional
pending
paid
canceled
Status codes
| Status | Descrição |
| 200 | Success |
| 404 | Assinatura não encontrada |
| 403 | Produtor não está no módulo beta. |
| 422 | Erro de validação |
| 422 | Cobrança adicional duplicada |
| 422 | Contrato não é infinito |
| 422 | Contrato PSL não permite adicionais |
Exemplos
1curl --request POST \
2 --url 'https://api.eduzz.com/myeduzz/v1/subscriptions/additional-charges' \
3 --header 'Accept: application/json' \
4 --data '
5{
6 "subscriptionId": "123456789",
7 "originKey": "example_tx_abc111101141",
8 "referenceDate": "2026-01-29",
9 "paymentStatusCallbackUrl": "https://seusite.../api/callback/...",
10 "contentId": "896",
11 "price": {
12 "currency": "BRL",
13 "value": 111
14 },
15 "description": "1 ativação avulsa email: fulano@aluno.com"
16}
17'Response
1{
2 "id": "b6d77c10-64ae-4abd-93c7-754b36b65468",
3 "originKey": "example_tx_abc1111011141",
4 "subscriptionId": "123456789",
5 "status": "pending"
6}