Criar cobrança Pix imediata

Resposta rápida: Com Bearer token e mTLS, faça PUT em /cob/{txid} com calendario, valor.original e chave; a resposta traz status e pixCopiaECola para o pagador.

Pré-requisitos

• Autenticar — {{ACCESS_TOKEN}} válido
• txid e identificadores
• Placeholders: {{MODOBANK_API_BASE_HML}}, {{TXID}}, {{PIX_KEY}}, cert/key

Passo a passo

1. Gere um txid válido (regras no OpenAPI BACEN).
2. Substitua placeholders nos snippets em snippets/.
3. Execute create-cob na sua stack.
4. Guarde pixCopiaECola / location da resposta para a recipe 04.
5. Valide campos obrigatórios no HML — o PSP pode exigir extras além do mínimo demo.

Código

Fontes canônicas:

• snippets/curl/create-cob.sh
• snippets/node/create-cob.mjs
• snippets/python/create_cob.py
• snippets/php/create-cob.php

curl

# source: snippets/curl/create-cob.sh
# see file for full body

Node.js

// source: snippets/node/create-cob.mjs

Python

# source: snippets/python/create_cob.py

PHP

// source: snippets/php/create-cob.php

Abra o arquivo em snippets/ da sua stack e execute-o após substituir tokens (conteúdo completo no path indicado).

Se der errado

Sintoma	Causa	Ação
400 RequisicaoInvalida	JSON/txid inválido	Conferir OpenAPI + charset do txid
403 AcessoNegado	Produto/escopo	Contrato com Modobank
401	Token expirado	Renovar token (recipe 02)

Checklist

• Cob criada em HML
• Resposta contém status e payload para QR
• txid gravado no seu pedido de negócio

Próximo passo

→ 04 — Exibir QR e copia-e-cola

FAQ

P: PUT ou POST?

R: O happy path com txid definido pelo cliente usa PUT /cob/{txid}; há também criação sem txid via POST /cob no OpenAPI — veja referência.