PayZu OnboardingIntegração

Criar a proposta embutida


Nesta páginaCrie a propostaEscolha o destinoErros desta operação

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" }
  }'

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 apareceembed
Na sua páginaorigin com a origem cadastrada da página.
No seu apphost em app, com returnUrl opcional.

Erros desta operação

CódigoHTTPMensagem
embed_origin_not_allowed400A origem não está entre as páginas autorizadas a embutir a jornada deste tenant.
embed_return_url_not_allowed400A URL de retorno não está entre as cadastradas para o app deste tenant.
embed_unavailable503O serviço não consegue assinar links embutidos neste ambiente.

Autenticação e validação estão no Catálogo de erros.