Checkout Page

Quick Reference

WhatHosted payment page

WhyCard data never touches your origin — A55 handles everything

DifficultyBeginner

PrerequisitesAuthentication → Create charge

Create the charge on your server, then redirect the buyer to A55's hosted experience. Card data never touches your domain — A55 manages card capture, encryption, and 3DS end-to-end.

---

Why hosted checkout

Benefit	Detail
Zero card data on your origin	Card entry handled entirely by A55
Multi-method	Cards, PIX, Apple Pay, Google Pay in one flow
Built-in 3DS	A55 runs 3DS inside confirmacion.a55.tech
Mobile-optimized	Responsive hosted pages
Fastest launch	Minimal frontend work beyond redirect

---

Flow

1. Create a charge via API (POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/).
2. Read charge_payment_url (or equivalent checkout URL) from the response.
3. Redirect the buyer to https://pay.a55.tech/checkout/v2/{uuid} (use the URL returned by the API when provided).

What the hosted page handles

Card entry, PIX QR display, Apple Pay / Google Pay, and 3DS inside A55-controlled domains.

Your responsibilities: create the charge with correct amount and currency, set redirect_url / return URLs as required, and subscribe to webhooks for final status.

---

Redirect code

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;

Environments

Keep charge UUIDs stable across environments; use sandbox hosts and credentials when testing redirects.

3DS on hosted checkout

Authentication runs inside A55's domain. You do not handle url_3ds manually for standard hosted checkout flows.

Payment link →Shareable URLs for invoices and campaigns.Environment →Sandbox vs production for pay.a55.tech.SDK V2 →Embedded iframe when you need on-site UX.