Pagamentos
Confirmar
Efetivar um pagamento Pix previamente iniciado
Confirma e liquida um pagamento iniciado por chave, QR Code ou manual. Sem esta chamada, o pagamento permanece INICIADO (status: "0").
Endpoint
POST /api/v2/pix/pagamentos/confirmar
Scope: pix.write
Headers
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | Sim | Bearer {{access_token}} |
Accept | Sim | application/json |
Content-Type | Sim | application/json |
Body (contrato real)
| Campo | Obrigatório | Descrição |
|---|---|---|
id | Sim | UUID da iniciação (404 se não existir) |
valor | Sim | Valor a efetivar (omitir → 500) |
chave_idempotencia | Sim | Única por intenção (omitir → 500, não 422) |
recebedor | Sim | Espelhar pessoa + conta da iniciação (omitir → 500) |
endToEndId | Não | Ignorado no body — vem do pagamento ou é gerado na confirmação |
pagador | Não | Montado da conta autenticada; envie pessoa.nome só se o titular não tiver nome |
descricao | Não | Mensagem |
prioridade_pagamento / tp_prioridade_pagamento | Não | Defaults 0 |
Payload mínimo
Mesmo formato para iniciação por chave, QR ou manual — copie o recebedor da resposta de iniciação:
{
"id": "{{pagamento_id}}",
"valor": 10.50,
"chave_idempotencia": "confirm-chave-001",
"recebedor": {
"pessoa": { "nome": "Recebedor DICT", "tipo": 0, "cpfCnpj": "98765432100" },
"conta": { "ispb": "87654321", "agencia": "0001", "conta": "7654321", "tipo": 0 }
}
}
Não envie endToEndId nem pagador (salvo fallback de nome).
Retorno
status | Significado |
|---|---|
"9" | Confirmado (débito efetivado) — comum em Pix interno (mesmo ISPB) |
"0" | Processando / aceito no JDPI — Pix externo pode evoluir para "9" |
"-1" | Erro |
Schema geral: Visão geral · Referência.
Idempotência
- Gere
chave_idempotencianova por intenção distinta. - Reutilize a mesma chave apenas em retentativa do mesmo pagamento.
Exemplo cURL
curl --location 'https://api-h.nuvende.com.br/api/v2/pix/pagamentos/confirmar' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
"id": "{{pagamento_id}}",
"valor": 10.50,
"chave_idempotencia": "confirm-chave-001",
"recebedor": {
"pessoa": { "nome": "Recebedor DICT", "tipo": 0, "cpfCnpj": "98765432100" },
"conta": { "ispb": "87654321", "agencia": "0001", "conta": "7654321", "tipo": 0 }
}
}'