PayZu OnboardingIntegração

Cadastrar páginas e apps


Nesta páginaGrave as listasCamposErros desta operação

Autorize as páginas que vão mostrar a jornada e os destinos para onde o seu app volta quando ela termina.

Grave as listas

bash
curl --request PUT \
  --url 'https://api.sandbox.payzu.dev/v1/settings/embed' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "allowedOrigins": ["https://painel.exemplo.com.br"],
    "returnUrls": ["exemplo://abertura-de-conta"]
  }'

A resposta repete as duas listas gravadas.

Referência: Alterar as páginas e apps autorizados

A gravação substitui as duas listas inteiras.

Leia a configuração atual em Consultar as páginas e apps autorizados, acrescente o que falta e grave as listas completas.

Campos

CampoRegra
allowedOriginsA origem de cada página, exatamente como o navegador a reporta: esquema, host e porta, sem caminho, sem barra no fim e sem curinga.
returnUrlsPara onde o app volta no fim da jornada. Vale a URL cadastrada e os caminhos abaixo dela.

Cada lista aceita até 50 itens, e o sandbox e a produção têm cadastros separados. O app que não usa returnUrl não precisa de cadastro.

Erros desta operação

CódigoHTTPMensagem
audience_not_found404Tenant não encontrado.

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