Skip to main content
PUT
Define o segredo de assinatura do webhook do Stripe

Authorizations

Authorization
string
header
required

Chave de API (prefixo rstr_) enviada como Authorization: Bearer rstr_....

Body

application/json
webhookSecret
string
required

Signing secret do webhook do Stripe (prefixo whsec_), usado para validar a assinatura dos eventos recebidos. Armazenado de forma segura e nunca retornado em texto puro.

Maximum string length: 255
Pattern: ^whsec_.*
Example:

"whsec_AbC123dEf456GhI789jKl012MnO345pQ"

secretKey
string

Secret key da API Stripe (prefixo sk_), opcional. Quando presente, habilita enriquecimento de cobranças com gatewayFeeCents e chargebacks via charge.dispute.created. String vazia ("") remove a key configurada.

Maximum string length: 255
Example:

"sk_test_4eC39HqLyjWDarjtT1zdp7dc"

Response

200 - application/json

Default Response

configured
boolean
required

Indica se o webhook secret do Stripe já está configurado para a organização.

Example:

true

webhookSecretLast4
string | null
required

Últimos 4 caracteres do webhook secret configurado, para conferência. null quando não há secret configurado.

Example:

"5pQ"

secretKeyLast4
string | null
required

Últimos 4 caracteres da secret key da API, quando configurada. null quando ausente.

Example:

"p7dc"