Persiste recebedor/conta sem DICT nem decode de QR. endToEndId e chave omitidos na iniciação; tipo: 0, valor: 0. Scope: pix.write.
Tipo de conteúdo aceito na resposta
stringTipo de conteúdo da requisição
stringRequer Bearer token com scope pix.write.
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | Sim | Bearer {{access_token}} |
Accept | Sim | application/json |
Content-Type | Sim | application/json |
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
recebedor.pessoa.nome | Recomendado | String | Nome |
recebedor.pessoa.cpfCnpj | Sim | String | CPF/CNPJ |
recebedor.conta.ispb | Sim | String | ISPB |
recebedor.conta.agencia | Sim | String | Agência |
recebedor.conta.numero | Sim | String | Conta com DV |
recebedor.conta.tipo | Sim | Integer | 0–4 |
txid | Não | String | Gerado se omitido |
tipo_pagamento | Não | String | Default manu |
| Campo | Valor típico |
|---|---|
endToEndId | Omitido até confirmar |
chave | Omitido |
valor | 0 |
tipo | 0 (manu) |
status | "0" |
| Código | Significado | Descrição |
|---|---|---|
| 200 | OK | Pagamento iniciado. |
| 201 | Created | Pagamento iniciado. |
| 400 | Bad Request | Parâmetros inválidos. |
| 401 | Unauthorized | Token inválido ou expirado. |
| 403 | Forbidden | Scope ou regra de conta. |
| 422 | Unprocessable Entity | Validação rejeitada. |
| 500 | Internal Server Error | Erro interno do servidor. |
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}}",
"nomeFantasia": "{{nome_fantasia_recebedor}}"
},
"conta": {
"ispb": "{{ispb}}",
"agencia": "0001",
"numero": "{{conta_recebedor}}",
"tipo": 0
}
},
"txid": "",
"tipo_pagamento": "manu"
}'
{
"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
}
const axios = require("axios");
const data = {
recebedor: {
pessoa: {
nome: "{{nome_recebedor}}",
cpfCnpj: "{{cpf_cnpj_recebedor}}",
nomeFantasia: "{{nome_fantasia_recebedor}}",
},
conta: {
ispb: "{{ispb}}",
agencia: "0001",
numero: "{{conta_recebedor}}",
tipo: 0,
},
},
txid: "",
tipo_pagamento: "manu",
};
axios
.post("https://api-h.nuvende.com.br/api/v2/pix/pagamentos/manual", data, {
headers: {
Accept: "application/json",
Authorization: "Bearer {{access_token}}",
"Content-Type": "application/json",
},
})
.then((response) => console.log(JSON.stringify(response.data)))
.catch((error) => console.log(error.response?.data || error.message));
import requests
url = "https://api-h.nuvende.com.br/api/v2/pix/pagamentos/manual"
headers = {
"Accept": "application/json",
"Authorization": "Bearer {{access_token}}",
"Content-Type": "application/json",
}
payload = {
"recebedor": {
"pessoa": {
"nome": "{{nome_recebedor}}",
"cpfCnpj": "{{cpf_cnpj_recebedor}}",
"nomeFantasia": "{{nome_fantasia_recebedor}}",
},
"conta": {
"ispb": "{{ispb}}",
"agencia": "0001",
"numero": "{{conta_recebedor}}",
"tipo": 0,
},
},
"txid": "",
"tipo_pagamento": "manu",
}
response = requests.post(url, headers=headers, json=payload)
print(response.text)
<?php
$payload = [
'recebedor' => [
'pessoa' => [
'nome' => '{{nome_recebedor}}',
'cpfCnpj' => '{{cpf_cnpj_recebedor}}',
'nomeFantasia' => '{{nome_fantasia_recebedor}}',
],
'conta' => [
'ispb' => '{{ispb}}',
'agencia' => '0001',
'numero' => '{{conta_recebedor}}',
'tipo' => 0,
],
],
'txid' => '',
'tipo_pagamento' => 'manu',
];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/pix/pagamentos/manual',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Accept: application/json',
'Authorization: Bearer {{access_token}}',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($payload),
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;