Criar sem txid
Criar cobrança Pix imediata via POST (txid gerado pela API)
Cria uma cobrança imediata (Cob) quando o integrador não define o txid antes da chamada. A API retorna o txid gerado no corpo da resposta.
Para definir o txid antecipadamente, use Criar QR Code (PUT).
Endpoint
POST /api/v2/cobranca/cob
Scope: cob.write
Headers
| Header | Obrigatório |
|---|---|
Authorization | Sim |
Content-Type | Sim — application/json |
Accept | Sim |
Body
Mesma estrutura do PUT — ver Criar QR Code.
Campos obrigatórios: chave, nomeRecebedor, calendario.expiracao, valor, devedor (nome + CPF ou CNPJ).
Resposta
Recurso Cob com txid, status, qrCode, calendario, valor, etc.
Exemplo
curl --location 'https://api-h.nuvende.com.br/api/v2/cobranca/cob' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data '{
"chave": "e3fe4462-4c8e-42c1-8360-b41b404ae557",
"nomeRecebedor": "Loja Exemplo",
"calendario": { "expiracao": 3600 },
"valor": { "original": "10.01", "modalidadeAlteracao": 0 },
"devedor": { "nome": "Maria Santos", "cpf": "39053344705" }
}'
SDK PHP
use Nuvende\Client;
use Nuvende\Requests\Cobrancas\SolicitacaoCobranca;
$cob = $client->cob()->criar($request); // POST /api/v2/cobranca/cob
echo $cob->txid;