Pagamentos
Manual
Iniciar pagamento Pix com dados bancários do recebedor (sem DICT nem QR)
Persiste recebedor e conta informados pelo cliente sem consulta DICT e sem decodificação de QR na iniciação. Status INICIADO (status: "0").
Endpoint
POST /api/v2/pix/pagamentos/manual
Scope: pix.write
Headers
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | Sim | Bearer {{access_token}} |
Accept | Sim | application/json |
Content-Type | Sim | application/json |
Body
{
"recebedor": {
"pessoa": {
"nome": "Fulano de Tal",
"cpfCnpj": "12345678900",
"nomeFantasia": "Fulano ME"
},
"conta": {
"ispb": "38297374",
"agencia": "0001",
"numero": "00001234",
"tipo": 0
}
},
"txid": "7978c0c97ea847e78e8849634473c1f1",
"tipo_pagamento": "manu"
}
| Campo | Obrigatório | Descrição |
|---|---|---|
recebedor.pessoa.nome | Recomendado | Nome do recebedor |
recebedor.pessoa.cpfCnpj | Sim | CPF/CNPJ |
recebedor.conta.ispb | Sim | ISPB do banco recebedor |
recebedor.conta.agencia | Sim | Agência |
recebedor.conta.numero | Sim | Conta com DV (campo lido pelo serviço) |
recebedor.conta.tipo | Sim | 0–4 (CC, salário, poupança, pagamento, PI) |
txid | Não | Gerado se omitido |
tipo_pagamento | Não | Default manu |
valor | Não* | Em alguns clientes o body inclui valor e pagador; o schema de iniciação tipicamente devolve valor: 0 |
*A confirmação sempre exige o valor a efetivar.
Retorno (200)
| Campo | Valor típico |
|---|---|
endToEndId | Omitido — gerado na confirmação |
chave | Omitido |
valor | 0 |
tipo | 0 (manu) |
rec_status | null |
Exemplo
{
"id": "e6f7a8b9-c0d1-2345-ef01-234567890def",
"valor": 0,
"txid": "manualTxid123456789012345678",
"status": "0",
"tipo": 0,
"id_req": null,
"recebedor": {
"pessoa": {
"nome": "Maria Recebedora",
"cpfCnpj": "98765432100",
"tipo": 0
},
"conta": {
"ispb": "00000000",
"agencia": "0001",
"conta": "00009999",
"tipo": 0
}
},
"pagador": {
"pessoa": {
"nome": "João Silva Exemplo",
"cpfCnpj": "39053344705",
"tipo": 0
},
"conta": {
"ispb": "38297374",
"agencia": "0001",
"conta": "00005678",
"tipo": 0
}
},
"dataHoraCriacao": "2026-07-08T13:15:00.000000Z",
"dataHoraAtualizacao": "2026-07-08T13:15:00.000000Z",
"tipo_transacao": -1,
"rec_status": null
}
Schema completo: Visão geral.
Exemplo cURL
curl --location 'https://api-h.nuvende.com.br/api/v2/pix/pagamentos/manual' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
"recebedor": {
"pessoa": {
"nome": "{{nome_recebedor}}",
"cpfCnpj": "{{cpf_cnpj_recebedor}}",
"tipo": 0
},
"conta": {
"ispb": "{{ispb}}",
"agencia": "0001",
"numero": "{{conta_recebedor}}",
"tipo": 0
}
},
"txid": ""
}'
Próximo passo
Confirmar pagamento — o endToEndId passa a existir após a confirmação.