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.
Gere o link
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ó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. |
proposal_not_found | 404 | Proposta não encontrada. |
proposal_not_open | 409 | A proposta já foi decidida, expirou ou foi cancelada. |
version_conflict | 409 | O registro mudou desde a leitura. Releia e tente de novo. |
proposal_expired | 410 | O prazo da proposta venceu. |
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.