Wallet payments - Zahlo Merchant Developer Docs

Wallets are conditional payment methods. A wallet appears only when it is enabled for the merchant and supported by the shopper’s device, browser, currency, amount, and checkout mode.

Discover eligible wallets

Query methods for the current session and render only enabled results. Do not show a wallet button that the API or device cannot support.

const { methods } = await fetch(
  "https://merchant.zahlo.eu/api/v1/payment-methods?currency=EUR&amountMinor=4990&mode=embedded",
  { headers: { "x-api-key": process.env.ZAHLO_API_KEY } },
).then((response) => response.json());
const wallets = methods.filter((method) =>
  ["apple_pay", "google_pay"].includes(method.type) && method.enabled,
);

The secure component owns wallet authorization. Your server owns the amount, order, idempotency key, event verification, and fulfillment decision.

Fallback behavior

If a wallet disappears after the page loads, keep the order and offer the other returned methods. If the wallet authorizes but confirmation is delayed, show pending and reconcile the same payment ID. Do not charge again because a wallet callback was interrupted.