Cria cobrança imediata sem txid no path — a API gera o identificador. Scope: cob.write. Alternativa ao PUT /cob/{txid}.
stringstringRequer Bearer token com scope cob.write.
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.
200 ou 201 com o recurso Cob criado (txid, status, qrCode, etc.).
| Código | Significado |
|---|---|
| 200 / 201 | Cobrança criada |
| 401 | Token inválido |
| 403 | Scope cob.write ausente |
| 422 | Validação |
PUT /api/v2/cobranca/cob/{txid} quando o integrador não define o txid antecipadamente.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.