POST/api/v2/pix/pagamentos/manual

Manual

Persiste recebedor/conta sem DICT nem decode de QR. endToEndId e chave omitidos na iniciação; tipo: 0, valor: 0. Scope: pix.write.

Parâmetros

AcceptObrigatório
header

Tipo de conteúdo aceito na resposta

Tipo:string
Content-TypeObrigatório
header

Tipo de conteúdo da requisição

Tipo:string

Autenticação e scopes

Requer Bearer token com scope pix.write.

Headers

HeaderObrigatórioDescrição
AuthorizationSimBearer {{access_token}}
AcceptSimapplication/json
Content-TypeSimapplication/json

Body

CampoObrigatórioTipoDescrição
recebedor.pessoa.nomeRecomendadoStringNome
recebedor.pessoa.cpfCnpjSimStringCPF/CNPJ
recebedor.conta.ispbSimStringISPB
recebedor.conta.agenciaSimStringAgência
recebedor.conta.numeroSimStringConta com DV
recebedor.conta.tipoSimInteger0–4
txidNãoStringGerado se omitido
tipo_pagamentoNãoStringDefault manu

Retorno 200

CampoValor típico
endToEndIdOmitido até confirmar
chaveOmitido
valor0
tipo0 (manu)
status"0"

Códigos de resposta

CódigoSignificadoDescrição
200OKPagamento iniciado.
201CreatedPagamento iniciado.
400Bad RequestParâmetros inválidos.
401UnauthorizedToken inválido ou expirado.
403ForbiddenScope ou regra de conta.
422Unprocessable EntityValidação rejeitada.
500Internal Server ErrorErro interno do servidor.

Notas

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;