POST/api/v2/cobranca/cob

Criar

Cria cobrança imediata sem txid no path — a API gera o identificador. Scope: cob.write. Alternativa ao PUT /cob/{txid}.

Parâmetros

AcceptObrigatório
header
Tipo:string
Content-TypeObrigatório
header
Tipo:string

Autenticação e scopes

Requer Bearer token com scope cob.write.

Body

Mesmos campos de Criar QR Code (PUT): chave, nomeRecebedor, calendario.expiracao, valor, devedor.

O txid não vai na URL — a API gera o identificador na resposta.

Retorno

200 ou 201 com o recurso Cob criado (txid, status, qrCode, etc.).

Códigos de resposta

CódigoSignificado
200 / 201Cobrança criada
401Token inválido
403Scope cob.write ausente
422Validação

Notas

  • Alternativa a PUT /api/v2/cobranca/cob/{txid} quando o integrador não define o txid antecipadamente.
  • Técnica: Criar sem txid.
curl --location 'https://api-h.nuvende.com.br/api/v2/cobranca/cob' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data '{
  "chave": "[email protected]",
  "nomeRecebedor": "Loja Exemplo LTDA",
  "calendario": { "expiracao": 3600 },
  "valor": { "original": "10.01", "modalidadeAlteracao": 0 },
  "devedor": { "nome": "Maria Pagadora Exemplo", "cpf": "11144477735" },
  "solicitacaoPagador": "Pedido 123"
}'
const axios = require("axios");

axios({
  method: "post",
  url: "https://api-h.nuvende.com.br/api/v2/cobranca/cob",
  headers: {
    "Content-Type": "application/json",
    Accept: "application/json",
    Authorization: "Bearer {{access_token}}",
  },
  data: {
    chave: "[email protected]",
    nomeRecebedor: "Loja Exemplo LTDA",
    calendario: { expiracao: 3600 },
    valor: { original: "10.01", modalidadeAlteracao: 0 },
    devedor: { nome: "Maria Pagadora Exemplo", cpf: "11144477735" },
    solicitacaoPagador: "Pedido 123",
  },
})
  .then((response) => console.log(JSON.stringify(response.data, null, 2)))
  .catch((error) => console.log(error.response?.data || error.message));
import requests

url = "https://api-h.nuvende.com.br/api/v2/cobranca/cob"
payload = {
    "chave": "[email protected]",
    "nomeRecebedor": "Loja Exemplo LTDA",
    "calendario": {"expiracao": 3600},
    "valor": {"original": "10.01", "modalidadeAlteracao": 0},
    "devedor": {"nome": "Maria Pagadora Exemplo", "cpf": "11144477735"},
    "solicitacaoPagador": "Pedido 123",
}
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer {{access_token}}",
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-h.nuvende.com.br/api/v2/cobranca/cob",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    "chave" => "[email protected]",
    "nomeRecebedor" => "Loja Exemplo LTDA",
    "calendario" => ["expiracao" => 3600],
    "valor" => ["original" => "10.01", "modalidadeAlteracao" => 0],
    "devedor" => ["nome" => "Maria Pagadora Exemplo", "cpf" => "11144477735"],
    "solicitacaoPagador" => "Pedido 123",
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Accept: application/json",
    "Authorization: Bearer {{access_token}}",
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
{
  "txid": "JsI6bA0QTb42rycbB8u6UzULCJHR2lC7QZd",
  "revisao": 0,
  "status": "ATIVA",
  "calendario": {
    "criacao": "2024-10-04T21:42:56.000000Z",
    "expiracao": 3600
  },
  "devedor": {
    "nome": "Maria Pagadora Exemplo",
    "cpf": "11144477735"
  },
  "valor": {
    "original": "10.01",
    "modalidadeAlteracao": 0
  },
  "qrCode": "00020126580014BR.GOV.BCB.PIX0136exemplo-payload-ficticio5204000053039865802BR5925Joao Recebedor Exemplo6009SAO PAULO62070503***6304ABCD",
  "chave": "[email protected]",
  "solicitacaoPagador": "Pedido 123",
  "pix": []
}
{
  "message": "The given data was invalid.",
  "errors": {
    "chave": ["The chave field is required."]
  }
}

O txid vem na resposta; use o qrCode (EMV) para exibir o QR Code ao pagador.