Tudásbázis
Apple Pay beállítása
Alapvetően az Apple Pay beállításának két fő lába van: a fizetési szolgáltatónál (pl. Stripe, Braintree, Checkout.com) és az Apple-bél is be kell állítani dolgokat. Előfeltétele, hogy a kereskedő rendelkezzen egy fiókkal a payment providernél, egy Apple Developer fiókkal, a tesztelő pedig egy olyan, Touch ID-val rendelkező Apple-készülékkel, amin nem használ éles szolgáltatásokat (pl. Apple Music, iCloud, stb.).
A Checkout.com fizetési szolgáltató esetében az alábbi lépéseket kell végrehajtani. Kétszer kell megcsinálni egyszer a sandbox környezethez, egyszer az éleshez később.
- Regisztrál a kereskedő egy Checkout.com fiókot. (Itt a ticketben láthatjuk az adatait.)
- Regisztrál a kereskedő egy Apple Developer accountot, és létrehoz a számunkra egy felhasználót (én csináltam magamnak a Sharan accountjával).
- Fontos! A kereskedő fogadja el az Apple Pay ÁSZF-et is (ha nem teszi meg, később sárga alertet látunk a domain validáció lépésnél [7.], itt mindenképp el kell fogadnia, az alertből el tudunk küldeni neki egy linket).
- Létrehozunk egy ún. Sandbox Apple ID-t. Ezzel kell majd bejelentkezni a tesztkészüléken, és hozzáadni egy tesztbankkártyát a Walletjához.
- Belépünk az Apple Developer Portalra.
- Megnyomjuk az Account gombot a fejlécben.
- Kiválasztjuk a People opciót. Ha rákérdez, akkor igen, „Go to App Store Connect”.
- A People fülön (ez a default) a bal hasábban a Sandbox szekcióban kiválasztjuk a Testers menüpontot.
- A lista bal felső sarkánál lévő picike + gombbal létrehozunk egy új Apple ID-t. Az adatokat értelemszerűen kitöltjük, e-mailt egyébként nem fog küldeni, de azért érdemes olyat használni, amihez hozzáférünk.
- Létrehozunk egy Apple Pay Merchant ID-t.
- Ehhez először is visszalépegetünk az Apple Developer Portal Account felületére.
- Kiválasztjuk a „Certificates, Identifiers & Profiles” opciót.
- A bal oldali listából rákattintunk az Identifiers opcióra.
- lista bal felső sarkánál lévő picike + gombra kattintunk.
- Kiválasztjuk a megjelenő listából a „Merchant IDs” opciót, majd felül Continue.
- Adunk neki egy tetszőleges nevet (esetünkben ez „istyleaesandbox”).
- Adunk neki egy Identifiert (esetünkben ez a nevezéktani konvencióknak megfelelően „merchant.ae.istyle.sandbox”).
- Continue majd Register. Itt megállunk és nem zárjuk be ezt a tabot.
- Megszerezzük a Checkout.comos CSR-t.
- Belépünk a The Hub™-ba (én is így nevezném el a hubomat).
- A baloldali menüben kiválasztjuk a Settings majd Apple Pay opciókat.
- Kiválasztjuk a businesst (általában csak egy lesz), majd megnyomjuk a New certificate gombot.
- A megjelenő popupban rákattintunk a picike „Download your certificate signing request” linkre. Letöltjük a fájlt. Majd Continue és még egyszer Continue. Itt megállunk, és nem zárjuk be ezt a tabot.
- Összepárosítjuk az Apple Pay Merchant ID-t a Checkout.com fiókkal (elkészítjük az Apple Pay Payment Processing tanúsítványunkat).
- Visszamegyünk oda az Apple Developer Portalon ahol félbehagytuk, és kiválasztjuk a Merchant ID-t.
- Az „Apple Pay Payment Processing Certificate” szekcióban (fontos, hogy ebben!) megnyomjuk a Create Certificate gombot.
- A megjelenő oldalon hagyjuk bekattintva a No opciót, majd Continue.
- A Choose File gombbal betallózzuk az 5.4. pontban letöltött CSR fájlt, majd Continue.
- A megjelenő oldalon a Download gombbal letöltjük az elkészült tanúsítványunkat. Érdemes átnevezni ezt a fájlt úgy, hogy ha kell, később is megtaláljuk. A példánban ez a „payment_processing_certificate_sandbox.cer”. Továbbra sem zárjuk be a tabot.
- Visszatabolunk a Checkout.com Hubra, és betallózzuk a letöltött CER fájlt. Nem zárjuk be a tabot.
- Validáljuk a domainünket.
- Visszamegyünk az Apple Developer portalra, majd az All Certificates gombbal visszalépünk a listára.
- Kiválasztjuk az Identifiers menüpontot, majd a megjelenő táblázatban a roppant látható és feltűnő, jobb felső sarokban lévő App IDs lenyílóból kiválasztjuk a Merchant IDs elemet.
- Kiválasztjuk a Merchant ID-t amivel eddig is dolgoztunk, majd a Merchant Domains szekcióban megnyomjuk az Add Domain gombot.
- Megadjuk annak a környezetnek a teljes domain nevét ahol be akarjuk állítani az Apple Payt. Save, majd Download.
- A kapott TXT fájlt odaadjuk az üzemeltetőnek, hogy töltse fel egy .well-known nevű mappába a weboldal gyökerébe. Esetünkben ez „https://dev.istyle.ae/.well-known/apple-developer-merchantid-domain-association.txt„. Itt egyébként bezárhatjuk a tabot ha akarjuk, vissza tudunk térni és később ugyaninnen folytatni.
- Ha fent van a fájl, nyomjuk meg a Verify gombot. Ne zárjuk be a tabot.
- Elkészítjük az Apple Pay Merchant ID tanúsítványunkat, ami majd a Checkout.com Magento 2 modulhoz fog kelleni.
- Nyitunk egy parancssort (Macen Terminal) és az alábbi paranccsal legeneráljuk a CSR és KEY fájljainkat:
openssl req -out uploadMe.csr -new -newkey rsa:2048 -nodes -keyout certificate_sandbox.key - Visszamegyünk a böngészőnkben az Apple Developer Portal felületre (ha bezártuk a tabot, akkor belépés, Account » Certificates, Identifiers & Profiles » Identifiers » App IDs / Merchant IDs » merchant ID kiválasztása) és az „Apple Pay Merchant Identity Certificate” szekcióban (fontos, hogy ebben!) megnyomjuk a Create Certificate gombot.
- Betallózzuk a 8.1. lépésben létrehozott uploadMe.csr fájlt, majd megnyomjuk a Continue, majd a Download gombot.
- A letöltött merchant_id.cer fájlt érdemes átnevezni, hogy később is megtaláljuk ha kell. Esetünben ez a merchant_identity_certificate_sandbox.cer.
- Átkonvertáljuk PEM formátumba az alábbi paranccsal szintén a parancssorban:
openssl x509 -inform der -in merchant_identity_certificate_sandbox.cer -out merchant_identity_certificate_sandbox.pem
- Nyitunk egy parancssort (Macen Terminal) és az alábbi paranccsal legeneráljuk a CSR és KEY fájljainkat:
- Payment Processing Certificate generálása
- Mivel Magentonak nem cer fájl hanem pem kell, így el kell készítenünk payment_processing_certificate_sandbox.cer fájlból a payment_processing_certificate_sandbox.pem fájlt.
- Futtassuk a mappában a „openssl x509 -inform der -in payment_processing_certificate_sandbox.cer -out payment_processing_certificate_sandbox_raw.pem” parancsot amivel legeneráljuk a nyers pem fájlt.
- Mivel a pem fájl jelen esetben kulcsot is kell tartalmazzon így illesszük be a kulcsunkat az elejére a következő paranccsal: „cat certificate_sandbox.key payment_processing_certificate_sandbox_raw.pem > payment_processing_certificate_sandbox.pem”
- Használjuk magento admin beállításánál a pem fájlt.
- Magento modul beállítása (ezt még nem csináltam végig, szóval ez az ahogy kb. elképzelem)
- Belépünk a megfelelő Magento webáruház adminjába.
- Elnavigálunk a Stores » Settings » Configuration » Sales » Payment Methods beállításokhoz, lenyíitjuk a Checkout.com beállításokat.
- A Basic Settings lenyíló alatt megadjuk az alapbeállításokat, erre most nem térünk ki.
- Lenyitjuk az Apple Pay lenyílót, majd konfiguráljuk az alábbiak szerint:
- Enable Apple Pay: Yes
- Debug: Yes (csak teszteléshez, a böngésző konzoljában fogja írni az esetleges hibaüzeneteket így)
- Title: Milyen néven jelenjen meg a pénztárban
- Sort Order: Hányadik legyen a listában
- Payment Processing Certificate: Fel kell tölteni a szerverre a megfelelő tanúsítványt (esetünkben a payment_processing_certificate_sandbox.pem) egy olyan biztonságos helyre, ahol nem csapja felül a deploy, és megadni az elérési útvonalat. Gyanús nekem, hogy ennek is inkább PEM formátumban kéne lennie, ebben az esetben a 8.5. lépés szerint konvertáljuk át.
- Processing Certificate Password: üres
- Merchant Identity Certificate: Fel kell tölteni a szerverre a megfelelő tanúsítványt (esetünkben a merchant_identity_certificate_sandbox.pem) egy olyan biztonságos helyre, ahol nem csapja felül a deploy, és megadni az elérési útvonalat.
- Merchant ID: A 4.7. pontban létrehozott ID. Esetünkben merchant.ae.istyle.sandbox.
- Button Style: Fekete vagy fehér vagy feketével keretezett fehér legyen-e a gomb. Ezt szigorúan szabályozza az Apple, esetünkben, világos háttér előtt feketének kell lennie.
- Supported Networks: A legtöbb kereskedő esetében az összes.
- Merchant Capabilities: A legtöbb kereskedő esetében mindkettő.
- Suported countries: Érdemes a kereskedő által valóban kiszolgált országokra limitálni.
- Bejelentkezünk a tesztkészüléken az Apple ID-val és hozzáadunk egy tesztkártyát a Walletjához. (macOS leírás következik)
- Elindítjuk a System Preferencest, majd kiválasztjuk az Apple ID menüpontot.
- Nincs előttem szüzen egy ilyen felület, de gondolom meg kell adni az e-mail címet és jelszót (lsd. feljebb kommentben).
- Visszalépünk a fő System Preferences ablakba, és kiválasztjuk a Wallet & Apple Pay menüpontot.
- A bal oldali oszlop alján megnyomjuk a kis + gombot.
- Nincs előttem szüzen a felület, de lesz egy Add a Debit or Credit Card vagy ilyesmi gomb.
- Kattintsunk az Enter Card Details Manually gombra, majd adjunk meg egy tetszőleges nevet és egy tesztkártyát az alábbiak közül.
- Meg is vagyunk, csupán ez a néhány lépés kellett, és már tesztelhetjük is az Apple Payt!
- Ne feledjük: Élesen ismételjük meg a folyamatot. Viszont ott már csak éles kártyával tudunk tesztelni!

