Checkout e SDK

O checkout Rivox tem uma só implementação. A mesma sessão, o mesmo payment intent e a mesma lista de métodos servem o checkout hospedado e o checkout embebido — muda apenas o enquadramento visual.

Checkout hospedado

Cada link de pagamento tem um endereço público. Redireccione o cliente e a Rivox trata da recolha, da confirmação e do resultado.

https://pagar.rivox.co.mz/{merchant}/{slug}

Checkout embebido

A mesma experiência dentro de um iframe no seu site. O iframe é servido pela Rivox: os dados de pagamento nunca passam pelo seu domínio.

https://pagar.rivox.co.mz/embed/{merchant}/{slug}

SDK JavaScript

O SDK é um script hospedado que monta o checkout embebido e reencaminha os eventos Rivox. Não calcula valores, não escolhe métodos e não confirma pagamentos.

<script src="https://sdk.rivox.co.mz/v1/rivox.js"></script>
<div id="rivox-checkout"></div>
<script>
  const rivox = Rivox.init("pk_live_...");
  const checkout = rivox.createCheckout({ merchant: "acme", slug: "plano-pro" });
  checkout.on("rivox:checkout.succeeded", (event) => {
    console.log("pago", event.intent);
  });
  checkout.mount("#rivox-checkout");
</script>

Eventos do checkout

• rivox:checkout.ready — a sessão foi aberta e o checkout está montado.
• rivox:checkout.succeeded — o pagamento foi confirmado pela Rivox.
• rivox:checkout.failed — a tentativa não foi concluída.
• rivox:checkout.unavailable — o link não está disponível.
• Os eventos do checkout servem a interface. A fonte de verdade para libertar valor continua a ser o webhook server-to-server.