Conceito

A implementação do SDK da IDPay no plugin WooCommerce exige a utilização de um domínio único, controlado exclusivamente pelo plugin. Esse ponto é obrigatório do ponto de vista técnico e não depende do domínio da loja do cliente final.

Regra

O SDK da IDPay será sempre executado no mesmo domínio, por exemplo:
https://dominioDoPlugin.com
As lojas WooCommerce (Loja A, Loja B, Loja C, etc.) não executam o SDK diretamente em seus próprios domínios.
O plugin é responsável por centralizar o checkout transparente e identificar corretamente qual loja está originando a transação.

Fluxo de navegação do cliente

Loja A

O cliente navega normalmente no site da Loja A.
Ao clicar em “Comprar” ou “Finalizar compra”, o plugin redireciona o cliente para: https://dominioDoPlugin.com/checkout
Nesse ambiente, o SDK da IDPay é inicializado e executado.
Durante a chamada à API PAYTIME, o plugin informa o establishment_idcorrespondente à Loja A.

Loja B

O cliente navega no site da Loja B.
Ao iniciar o pagamento, o fluxo é igualmente redirecionado para:https://dominioDoPlugin.com/checkout
O SDK da IDPay é executado exatamente no mesmo domínio.

Na comunicação com nossa API, o plugin envia o establishment_id correspondente à Loja B.

Ponto-chave da arquitetura

O domínio do checkout é sempre o mesmo, independentemente da loja.
A diferenciação entre lojas não ocorre por domínio, mas sim por identificação lógica, através do:
- establishment_id
- Metadados internos do plugin

O plugin é o responsável por mapear:

Loja WooCommerce → `establishment_id`

Chamada à API (conceito)

Sempre que o plugin realizar chamadas à nossa API (criação de transação, antifraude, etc.), ele deve informar explicitamente establishment_id

Isso garante que:

A transação seja corretamente associada à loja de origem
O SDK possa operar de forma centralizada e segura
Não haja dependência do domínio da loja WooCommerce

Conclusão técnica

✔ O SDK da IDPay não deve ser executado em múltiplos domínios

✔ O plugin deve operar com checkout centralizado

✔ A segregação entre lojas ocorre via establishment_id