PayZu OnboardingIntegração

Gerar outro link embutido


Peça outro link quando a sua tela perder a embedUrl ou receber o evento closed com unavailable numa proposta ainda aberta.

bash
curl --request POST \
  --url 'https://api.sandbox.payzu.dev/v1/proposals/cmf0p8x1a0001qk08prop0001/actions/issue-link' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "embed": { "host": "app", "returnUrl": "exemplo://abertura-de-conta" },
    "expectedVersion": 3
  }'

A resposta traz a proposta com o link novo em embedUrl.

Referência: Gerar um link da jornada

  • Link anterior: para de abrir na hora.
  • Cliente: confirma o código de novo e retoma de onde parou.
  • Com embed: o link novo vai para outra página ou app cadastrado, como do site para o app.
  • Sem embed: o destino continua o mesmo.

Na jornada embutida, a emissão vale enquanto a página ainda pode abrir, inclusive em análise.

Com closed e reason em expired, a emissão é recusada com proposal_expired. Crie outra proposta, com outro clientCode.

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.
proposal_not_found404Proposta não encontrada.
proposal_not_open409A proposta já foi decidida, expirou ou foi cancelada.
version_conflict409O registro mudou desde a leitura. Releia e tente de novo.
proposal_expired410O prazo da proposta venceu.
embed_unavailable503O serviço não consegue assinar links embutidos neste ambiente.

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