AcapaPay · Laravel SDK

Integração de Interface — Blade Component iFrame

Visão Geral

Para uma experiência premium sem redirecionar o utilizador para fora do seu site, o SDK fornece um componente Blade que embute o checkout do AcapaPay num iFrame seguro dentro da sua página. O componente escuta eventos postMessage transmitidos pelo SSO e reage automaticamente quando o pagamento é concluído, redirecionando a janela pai para o seu URL de sucesso.

Uso na View Blade

<x-layout>
    <div class="checkout-container">
        <h1>Concluir o Pagamento — {{ $plano->name }}</h1>

        
        <x-acapapay::iframe
            :checkout-url="$urlPagamento"
            height="600px"
            class="w-full rounded-xl border"
        />
    </div>
</x-layout>

Como Funciona o Redirecionamento Automático

1. O utilizador completa o pagamento dentro do iFrame no domínio do SSO.
2. O SSO confirma a transação e emite um evento postMessage com o estado payment_success para a janela pai.
3. O componente Blade tem JavaScript nativo que escuta este evento.
4. Ao detetar o sucesso, redireciona automaticamente o browser para o seu success_url.