Acessar minha contaAbrir uma conta
POST/api/v2/baas/bankslip-payments/update/{reference}

Atualizar

Produto BaaS (titular). Requer Bearer JWT do login da conta e assinatura HMAC obrigatória. Scope: baas.bankslip-payments.write. Guia: documentação técnica.

Parâmetros

Content-TypeObrigatório
header
Tipo:string
AcceptObrigatório
header
Tipo:string
X-SignatureObrigatório
header

Assinatura HMAC-SHA256 da requisição (hex).

Tipo:string
X-TimestampObrigatório
header

Timestamp Unix (segundos, UTC) usado na assinatura.

Tipo:string
X-NonceObrigatório
header

Nonce único por requisição (anti-replay).

Tipo:string
referenceObrigatório
path

reference retornado no GET barcode (formato barcode_data_documento).

Tipo:string

Autenticação e headers

Requer Bearer token do login da conta e assinatura HMAC obrigatórios. Scope: baas.bankslip-payments.write.

Envie X-Signature, X-Timestamp e X-Nonce em todo pedido assinado. Veja Autenticação do parceiro.

HeaderObrigatórioDescrição
AuthorizationSimBearer {{access_token}}
Content-TypeSimapplication/json
AcceptSimapplication/json
X-SignatureSimAssinatura HMAC (corpo JSON idêntico na assinatura)
X-TimestampSimTimestamp da assinatura
X-NonceSimNonce único por requisição

Body

CampoObrigatórioFormatoObservação
totalSimDecimal em reaisEx.: 152.00 (diferente dos centavos na consulta)
scheduled_forSimdd/mm/AAAAHoje ou data futura
beneficiary_nameSimstringConforme consulta
beneficiary_documentNão11 a 14 dígitosCPF/CNPJ só números
observationNãostringAté 500 caracteres

Quando usar

Etapa opcional entre revisão e confirmação: boleto de valor divergente ou agendamento em data futura.

Saldo da conta é validado contra o total informado.

Erros comuns

SituaçãoHTTP
reference inválida422
Saldo insuficiente422

Códigos

CódigoDescrição
200Atualizado
401Token ou HMAC inválido
403Scope ausente
422Validação ou regra de negócio

Notas

curl --request POST \
  --url 'https://api-h.nuvende.com.br/api/v2/baas/bankslip-payments/update/23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107' \
  --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 '{
  "total": 152.00,
  "scheduled_for": "16/07/2026",
  "beneficiary_name": "Loja Exemplo LTDA",
  "beneficiary_document": "43587980000107",
  "observation": "Pagamento ref. fatura exemplo 001"
}'

const axios = require("axios");

const reference = "23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107";
const data = {
  total: 152.0,
  scheduled_for: "16/07/2026",
  beneficiary_name: "Loja Exemplo LTDA",
  beneficiary_document: "43587980000107",
  observation: "Pagamento ref. fatura exemplo 001",
};

axios({
  method: "post",
  url: `https://api-h.nuvende.com.br/api/v2/baas/bankslip-payments/update/${reference}`,
  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

reference = "23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107"
url = f"https://api-h.nuvende.com.br/api/v2/baas/bankslip-payments/update/{reference}"
payload = {
    "total": 152.00,
    "scheduled_for": "16/07/2026",
    "beneficiary_name": "Loja Exemplo LTDA",
    "beneficiary_document": "43587980000107",
    "observation": "Pagamento ref. fatura exemplo 001",
}
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "X-Timestamp": "{{timestamp}}",
    "X-Nonce": "{{nonce}}",
    "X-Signature": "{{signature}}",
}
response = requests.post(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/bankslip-payments/update/23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
  "total": 152.00,
  "scheduled_for": "16/07/2026",
  "beneficiary_name": "Loja Exemplo LTDA",
  "beneficiary_document": "43587980000107",
  "observation": "Pagamento ref. fatura exemplo 001"
}',
  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;

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "reference": "23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107",
  "status": "consulted",
  "total": 15200,
  "scheduled_for": "2026-07-16T00:00:00Z"
}

{
  "message": "Boleto não encontrado ou inválido."
}

{
  "message": "Saldo insuficiente para o pagamento desse boleto."
}