PayZu OnboardingIntegração
Criar a proposta embutida
Crie a proposta com embed, junto dos campos de Criar uma proposta, e receba o link que a sua tela abre.
Crie a proposta
bash
curl --request POST \
--url 'https://api.sandbox.payzu.dev/v1/proposals' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"clientCode": "painel-4472",
"type": "COMPANY",
"taxId": "11.222.333/0001-81",
"contact": "financeiro@empresa.com.br",
"embed": { "origin": "https://painel.exemplo.com.br" }
}'json
{
"id": "cmf0p8x1a0001qk08prop0001",
"clientCode": "painel-4472",
"type": "COMPANY",
"taxId": "11222333000181",
"contact": "financeiro@empresa.com.br",
"status": "CREATED",
"delivery": "EMBEDDED",
"expiresAt": "2026-09-24T12:00:00.000Z",
"submittedAt": null,
"decidedAt": null,
"version": 0,
"createdAt": "2026-09-17T12:00:00.000Z",
"updatedAt": "2026-09-17T12:00:00.000Z",
"journeyUrl": null,
"embedUrl": "https://jornada.sandbox.payzu.dev/embed/Qm9hIHZpYWdlbSBkZSB0ZXN0ZSBkbyBsaW5r?o=https%3A%2F%2Fpainel.exemplo.com.br&s=4f1c9a7e2b6d3085c1e4a7b29d6f0c3e8b5a2d7f1c9e4b6a3d8f0c2e5b7a9d1e"
}Referência: Criar uma proposta de abertura de conta
Guarde a embedUrl no seu backend e entregue-a à sua tela por uma chamada autenticada.
Nunca a ponha em log, na URL de uma página, em analytics ou em gravação de sessão. Ela vem uma vez só, e nenhuma consulta retorna o link de novo.
Escolha o destino
| Onde a jornada aparece | embed |
|---|---|
| Na sua página | origin com a origem cadastrada da página. |
| No seu app | host em app, com returnUrl opcional. |
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
embed_origin_not_allowed | 400 | A origem não está entre as páginas autorizadas a embutir a jornada deste tenant. |
embed_return_url_not_allowed | 400 | A URL de retorno não está entre as cadastradas para o app deste tenant. |
embed_unavailable | 503 | O serviço não consegue assinar links embutidos neste ambiente. |
Autenticação e validação estão no Catálogo de erros.