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

Confirmar

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

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}}
AcceptSimapplication/json
X-SignatureSimAssinatura HMAC
X-TimestampSimTimestamp da assinatura
X-NonceSimNonce único por requisição

Path e body

CampoRegra
{reference}Da consulta por código de barras
BodyVazio ou {}

Resposta de sucesso

200 OK: status processing (débito imediato na janela 07:00 a 16:00, horário de Brasília) ou scheduled (agendado).

Após sucesso o pagamento não é revertido pelo integrador.

Erros comuns

SituaçãoHTTP
Fora do horário permitido422
reference inválida422
Falha no processamento422

Códigos

CódigoDescrição
200Confirmado ou agendado
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/confirm/23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'X-Timestamp: {{timestamp}}' \
  --header 'X-Nonce: {{nonce}}' \
  --header 'X-Signature: {{signature}}'

const axios = require("axios");

const reference = "23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107";

axios({
  method: "post",
  url: `https://api-h.nuvende.com.br/api/v2/baas/bankslip-payments/confirm/${reference}`,
  headers: {
    Accept: "application/json",
    Authorization: "Bearer {{access_token}}",
    "X-Timestamp": "{{timestamp}}",
    "X-Nonce": "{{nonce}}",
    "X-Signature": "{{signature}}",
  },
})
  .then((response) => console.log(JSON.stringify(response.data)))
  .catch((error) => console.log(error.response?.data || error.message));

import requests

reference = "23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107"
url = f"https://api-h.nuvende.com.br/api/v2/baas/bankslip-payments/confirm/{reference}"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "X-Timestamp": "{{timestamp}}",
    "X-Nonce": "{{nonce}}",
    "X-Signature": "{{signature}}",
}
response = requests.post(url, headers=headers)
print(response.text)

<?php
$curl = curl_init();
$opts = [
  CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/baas/bankslip-payments/confirm/23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    '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": "processing",
  "total": 15200,
  "confirmed_at": "2026-07-15T14:30:00Z",
  "scheduled_for": null,
  "payer_name": "Maria Pagadora Exemplo",
  "payer_document": "11144477735"
}

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "reference": "23793381286008301352856000063330894325100000015200_2026-07-15_43587980000107",
  "status": "scheduled",
  "total": 15200,
  "confirmed_at": "2026-07-15T14:30:00Z",
  "scheduled_for": "2026-07-16T07:15:00Z",
  "payer_name": "Maria Pagadora Exemplo",
  "payer_document": "11144477735"
}

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

{
  "message": "Pagamento não disponível neste momento. Horário permitido: 07:00 às 16:00."
}

{
  "message": "Não é possível confirmar o pagamento. Tente novamente mais tarde."
}