Página de checkout

Quick Reference

WhatPágina de pagamento hospedada

WhyDados de cartão nunca tocam sua origem — totalmente gerenciado pela A55

DifficultyBeginner

PrerequisitesAutenticação → Criar cobrança

Crie a cobrança no seu servidor e redirecione o comprador para a experiência hospedada da A55. Dados de cartão nunca tocam seu domínio — a A55 cuida de toda a segurança dos dados de pagamento para você.

---

Por que checkout hospedado

Benefício	Detalhe
Zero dados de cartão na sua origem	Entrada de cartão inteiramente pela A55
Multimétodo	Cartões, PIX, Apple Pay e Google Pay em um fluxo
3DS integrado	A A55 executa 3DS dentro de confirmacion.a55.tech
Otimizado para mobile	Páginas hospedadas responsivas
Lançamento rápido	Pouco trabalho no frontend além do redirecionamento

---

Fluxo

1. Crie a cobrança via API (POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/).
2. Leia charge_payment_url (ou URL de checkout equivalente) na resposta.
3. Redirecione o comprador para https://pay.a55.tech/checkout/v2/{uuid} (use a URL retornada pela API quando fornecida).

O que a página hospedada trata

Entrada de cartão, exibição do QR PIX, Apple Pay / Google Pay e 3DS em domínios controlados pela A55.

Suas responsabilidades: criar a cobrança com valor e moeda corretos, definir redirect_url / URLs de retorno conforme necessário e assinar webhooks para o status final.

---

Código de redirecionamento

JavaScript

window.location.href = chargePaymentUrl;

Python

from flask import redirect

@app.route("/pay/<charge_uuid>")
def pay(charge_uuid):
    charge_payment_url = create_charge(charge_uuid)
    return redirect(charge_payment_url)

Node.js

app.get("/pay/:chargeUuid", async (req, res) => {
  const chargePaymentUrl = await createCharge(req.params.chargeUuid);
  res.redirect(302, chargePaymentUrl);
});

Go

http.HandleFunc("/pay/", func(w http.ResponseWriter, r *http.Request) {
    chargePaymentURL := createCharge(r.PathValue("chargeUuid"))
    http.Redirect(w, r, chargePaymentURL, http.StatusFound)
})

Java

@GetMapping("/pay/{chargeUuid}")
public void pay(@PathVariable String chargeUuid, HttpServletResponse response)
        throws IOException {
    String chargePaymentUrl = createCharge(chargeUuid);
    response.sendRedirect(chargePaymentUrl);
}

PHP

<?php
$chargePaymentUrl = createCharge($chargeUuid);
header("Location: " . $chargePaymentUrl);
exit;

Ambientes

Mantenha UUIDs de cobrança estáveis entre ambientes; use hosts e credenciais de sandbox ao testar redirecionamentos.

3DS no checkout hospedado

A autenticação roda dentro do domínio da A55. Você não trata url_3ds manualmente nos fluxos padrão de checkout hospedado.

Link de pagamento →URLs compartilháveis para faturas e campanhas.Ambiente →Sandbox vs produção para pay.a55.tech.SDK V2 →Iframe embutido quando você precisa de UX no site.