Produto BaaS (titular). Requer Bearer JWT do login da conta e assinatura HMAC obrigatória. Scope: baas.webhooks.write. Guia: documentação técnica.
stringAssinatura HMAC-SHA256 da requisição (hex).
stringTimestamp Unix (segundos, UTC) usado na assinatura.
stringNonce único por requisição (anti-replay).
stringintegerRequer Bearer token do login da conta e assinatura HMAC obrigatórios.
Scope: baas.webhooks.write.
Envie X-Signature, X-Timestamp e X-Nonce em todo pedido assinado. Veja Assinatura HMAC.
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | Sim | Bearer {{access_token}} |
Accept | Sim | application/json |
X-Signature | Sim | Assinatura HMAC |
X-Timestamp | Sim | Timestamp da assinatura |
X-Nonce | Sim | Nonce único por requisição |
Mesmos campos do POST, todos opcionais.
| Código | Descrição |
|---|---|
| 200 | OK |
| 201 | Recurso criado |
| 400 | Parâmetros inválidos |
| 401 | Token ou HMAC inválido |
| 403 | Scope ausente |
| 404 | Não encontrado |
| 422 | Validação ou regra de negócio |
| 500 | Erro interno |
curl --request PATCH \
--url 'https://api-h.nuvende.com.br/api/v2/baas/webhooks/1' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'X-Timestamp: {{timestamp}}' \
--header 'X-Nonce: {{nonce}}' \
--header 'X-Signature: {{signature}}' \
--data '{"url":"https://integrador.exemplo.com.br/webhooks/conta/pix-v2","status":"ACTIVE"}'
const axios = require("axios");
const data = {
"url": "https://integrador.exemplo.com.br/webhooks/conta/pix-v2",
"status": "ACTIVE"
};
axios({
method: "patch",
url: "https://api-h.nuvende.com.br/api/v2/baas/webhooks/1",
headers: {
"Content-Type": "application/json",
Accept: "application/json",
Authorization: "Bearer {{access_token}}",
"X-Timestamp": "{{timestamp}}",
"X-Nonce": "{{nonce}}",
"X-Signature": "{{signature}}",
},
data,
})
.then((response) => console.log(JSON.stringify(response.data)))
.catch((error) => console.log(error.response?.data || error.message));
import json
import requests
url = "https://api-h.nuvende.com.br/api/v2/baas/webhooks/1"
payload = {
"url": "https://integrador.exemplo.com.br/webhooks/conta/pix-v2",
"status": "ACTIVE"
}
headers = {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Bearer {{access_token}}",
"X-Timestamp": "{{timestamp}}",
"X-Nonce": "{{nonce}}",
"X-Signature": "{{signature}}",
}
response = requests.patch(url, headers=headers, data=json.dumps(payload))
print(response.text)
<?php
$curl = curl_init();
$opts = [
CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/baas/webhooks/1',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'PATCH',
CURLOPT_POSTFIELDS => '{"url":"https://integrador.exemplo.com.br/webhooks/conta/pix-v2","status":"ACTIVE"}',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Accept: application/json',
'Authorization: Bearer {{access_token}}',
'X-Timestamp: {{timestamp}}',
'X-Nonce: {{nonce}}',
'X-Signature: {{signature}}',
],
];
curl_setopt_array($curl, $opts);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
{
"id": 1,
"url": "https://integrador.exemplo.com.br/webhooks/conta/pix-v2",
"status": "ACTIVE",
"events": [
"pix-received",
"pix-sent"
],
"method": "POST",
"created_at": "2025-01-10T08:00:00Z"
}