cardcom-checkout
Build a custom, fully working checkout on your own website with Cardcom (קארדקום, Israel) — own-design card form (Open Fields), Apple Pay (also on PC/Android via Apple's QR code), Google Pay, Bit and PayPal, verified server-side. Covers the Cardcom panel setup (API key, Google Pay, Apple Pay domain registration, Bit, PayPal), the server, the page, testing with a real small charge, and troubleshooting. Use when someone wants Cardcom payments inside their own site/design, asks how to set up Apple Pay / Google Pay / Bit with Cardcom, or their Cardcom wallet buttons don't show.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/natanelnf--cardcom-checkout-skill)HTML
<a href="/listings/natanelnf--cardcom-checkout-skill"><img src="/api/listings/natanelnf--cardcom-checkout-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/Natanelnf/cardcom-checkout-skill ~/.claude/skills/cardcom-checkout
(or download the ZIP and put the folder at `~/.claude/skills/cardcom-checkout/`). Then ask Claude, e.g. "set up Cardcom payments with Apple Pay on my site".
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 52 lines
- ---
- name: cardcom-checkout
- description: Build a custom, fully working checkout on your own website with Cardcom (קארדקום, Israel) — own-design card form (Open Fields), Apple Pay (also on PC/Android via Apple's QR code), Google Pay, Bit and PayPal, verified server-side. Covers the Cardcom panel setup (API key, Google Pay, Apple Pay domain registration, Bit, PayPal), the server, the page, testing with a real small charge, and troubleshooting. Use when someone wants Cardcom payments inside their own site/design, asks how to set up Apple Pay / Google Pay / Bit with Cardcom, or their Cardcom wallet buttons don't show.
- ---
- # Cardcom checkout — own design, all wallets
- A field-tested recipe (built and charged for real, Nov 2026) for taking payments through Cardcom **inside your own page**:
- your own buttons and layout, Cardcom's secure iframes for the card number and CVV, and the official wallet buttons.
- ```
- browser ──(1) POST /api/checkout {productId}──► your server ──LowProfile/Create──► Cardcom
- ◄────────── lowProfileId, bitUrl, paypalUrl ─────────
- ──(2) Open Fields iframes (card, CVV, Google Pay, Apple Pay) ◄──► Cardcom (postMessage)
- ──(3) "success" message ──► GET /api/order?id ──► your server ──LowProfile/GetLpResult──► Cardcom
- ◄────────── paid / failed (the only truth) ─────────
- ```
- ## Rules (do not skip)
- - **Secrets stay on the server.** `ApiName` (and `ApiPassword` if you ever need it) live in `.env` / host env vars. Never
- in the page, never in git, never pasted into chat. Prices live on the server — the browser sends a product id only.
- - **Never trust the browser.** "Success" from the page, a redirect, or the webhook body is a hint. The order is paid only when
- `LowProfile/GetLpResult` says `ResponseCode 0`, the `ReturnValue` matches the order and the amount matches.
- - The server must be **public HTTPS** — Cardcom rejects a `localhost` webhook (error 5170). Test on a real host
- (Render, Railway, Fly, a VPS) or a tunnel.
- - Use `secure.cardcom.solutions` only (not the old `secure.cardcom.co.il`).
- - Card number and CVV are typed **only** into Cardcom's iframes. Your own inputs: name, expiry, ID, phone/email.
- - Ask the merchant before: real charges, refunds, saving panel settings, creating API keys, DNS changes.
- ## Steps
- 1. **Panel setup** — API key, wallets, Apple Pay domain: `references/panel-setup.md`.
- 2. **Server** — copy `templates/server.js` + `templates/env.example`, fill products and env, deploy. Node 18+, no packages.
- 3. **Page** — copy `templates/public/checkout.html` + `templates/public/apple-relay.html` and the Apple file into `public/.well-known/`.
- Restyle freely; keep the iframe ids/names and the message handling. Protocol details: `references/open-fields.md`.
- 4. **Apple Pay everywhere** (PC / Android / Chrome via QR code) is already in the templates — how and why:
- `references/apple-pay-anywhere.md`.
- 5. **Test with a real small charge** (e.g. ₪1–2), one per method, then refund from the Cardcom panel: `references/testing.md`.
- 6. Something missing or failing: `references/troubleshooting.md`.
- ## Which button shows where (expected behaviour)
- | Method | Shows when | Notes |
- | --- | --- | --- |
- | Card | always | Cardcom fields; 3DS needs phone **or** email |
- | Apple Pay | Safari on iPhone/iPad/Mac → Cardcom's frame. Other browsers → our top-page button with Apple's QR code (iPhone iOS 18+ scans it) | Domain must be registered for Apple Pay in the Cardcom panel |
- | Google Pay | Cardcom's frame reports Google's `isReadyToPay` = true (most normal browsers, incl. Safari) | Not inside Facebook/Instagram in-app browsers. Single payment only |
- | Bit | Cardcom returns `UrlToBit` (Bit enabled on the terminal) | Redirect flow, returns to your page |
- | PayPal | Cardcom returns `UrlToPayPal` (PayPal enabled on the terminal by Cardcom) | Redirect flow |
- Never show a wallet button that cannot work (Google's and Apple's brand rules); card and Bit are always the fallback.
README.md · README · 35 lines
- # cardcom-checkout — Claude skill
- A Claude Code skill for building a fully working checkout on your own website with **Cardcom** (קארדקום, Israel):
- own-design card form (Open Fields), **Apple Pay** (also on PC / Android via Apple's QR code), **Google Pay**, **Bit** and
- **PayPal**, verified server-side — plus the Cardcom panel setup (API key, wallets, Apple Pay domain registration).
- ## Install
- ```bash
- git clone https://github.com/Natanelnf/cardcom-checkout-skill ~/.claude/skills/cardcom-checkout
- ```
- (or download the ZIP and put the folder at `~/.claude/skills/cardcom-checkout/`). Then ask Claude, e.g.
- "set up Cardcom payments with Apple Pay on my site".
- ## What's inside
- | Path | |
- | --- | --- |
- | `SKILL.md` | the recipe and rules |
- | `references/panel-setup.md` | Cardcom panel: API key, Google Pay, Apple Pay domain registration, Bit, PayPal |
- | `references/open-fields.md` | the Open Fields protocol (frames, messages, verification) |
- | `references/apple-pay-anywhere.md` | Apple Pay outside Safari (QR code) with Cardcom |
- | `references/testing.md`, `references/troubleshooting.md` | testing with a small real charge, common problems |
- | `templates/` | working Node server (no packages) + payment page |
- ## Notes
- - No keys are included. Your `ApiName` goes in environment variables only.
- - The Apple Pay QR flow uses Cardcom's internal Open Fields endpoints (the same ones Cardcom's own script calls). Verified
- working Nov 2026; it may need updating if Cardcom changes their script.
- - Not affiliated with Cardcom, Apple or Google.
- ---
- **בעברית:** סקיל ל-Claude להקמת דף תשלום בעיצוב שלכם עם קארדקום — כרטיס אשראי בשדות מאובטחים, Apple Pay (גם במחשב
- ובאנדרואיד בסריקת QR), Google Pay, ביט ו-PayPal, כולל כל ההגדרות בפאנל של קארדקום ורישום דומיין ל-Apple Pay.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.