Adicionar uma cobrança adicional

Adiciona uma cobrança adicional na assinatura do cliente

Required scopes:myeduzz_subscriptions_write

POST

https://api.eduzz.com/myeduzz/v1/subscriptions/additional-charges

Endpoint em desenvolvimento
Este endpoint ainda está em desenvolvimento e ficará disponível em breve

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)

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
422	Erro de validação
422	Cobrança adicional duplicada

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}