Plugin Coinbase Commerce pripája platbu v kryptomenách — zákazník platbu potvrdí priamo v pokladni a až potom je presmerovaný na hostovanú platobnú stránku Coinbase, kde vybranú kryptomenu odošle.
Čo plugin robí
Po výbere platby Coinbase Commerce v pokladni sa vytvorí platba s pevnou cenou v mene objednávky (napríklad v eurách) a zákazník je po potvrdení presmerovaný na hostovanú stránku Coinbase, kde vidí sumu na úhradu v konkrétnej kryptomene podľa aktuálneho kurzu.
Požiadavky
Účet na dashboard.commerce.coinbase.com s API kľúčom a webhook shared secretom.
Nastavenia
| Pole | Význam |
|---|---|
| API Key | API kľúč z dashboard.commerce.coinbase.com. Po uložení sa zašifruje. |
| Webhook Shared Secret | Zdieľaný kľúč na overenie webhook notifikácií. Po uložení sa zašifruje. |
Plugin zámerne nemá prepínač „testovací režim" — Coinbase Commerce nemá samostatné sandbox prostredie, takže takýto prepínač by na správanie pluginu nemal žiadny vplyv.
Inštalácia a nastavenie
- Otvorte Systém > Pluginy a zapnite plugin Coinbase Commerce.
- V Coinbase Commerce dashboarde vytvorte API kľúč a webhook so shared secretom.
- Vložte obe hodnoty do nastavení pluginu a uložte.
Ako otestovať platbu
Coinbase Commerce neponúka testovacie prostredie ani testovacie API kľúče — každý API kľúč komunikuje s produkčným prostredím. Overte funkčnosť jedným z týchto spôsobov:
- Malá reálna platba. Vytvorte objednávku na symbolickú sumu (napr. 1 €), zaplaťte kryptomenou a overte, že sa po potvrdení webhooku označí ako zaplatená.
- Simulácia webhooku. V Coinbase Commerce dashboarde (Settings → Webhook subscriptions) je možné pre nakonfigurovaný endpoint odoslať testovaciu udalosť (napr.
charge:confirmed) bez reálnej platby — overí sa tak spracovanie notifikácie na strane Ecommio nezávisle od skutočnej platby.
Čo sa deje na objednávke
Návrat zákazníka z hostovanej stránky Coinbase (úspech aj zrušenie) sám osebe stav objednávky nemení — pri kryptoplatbách totiž samotný návrat nič nedokazuje (rovnaká stránka sa zobrazí aj pri čakajúcej alebo nedoplatenej platbe). Objednávka sa označí ako zaplatená výhradne na základe potvrdzujúcej webhook notifikácie od Coinbase. Suma sa pri kryptoplatbách osobitne neporovnáva — Coinbase notifikáciu o potvrdení posiela až po prijatí plnej sumy.
Refundácie
Kryptomenové platby nie je možné refundovať cez API Coinbase Commerce — prípadné vrátenie treba vyriešiť mimo Ecommio, priamou platbou zákazníkovi.
Webhook
Coinbase Commerce posiela notifikáciu na payments/coinbase/webhook, podpísanú zdieľaným tajomstvom (Webhook Shared Secret) — bez správne nastaveného tajomstva sa notifikácia neuzná a objednávka sa nikdy neoznačí ako zaplatená, aj keď zákazník reálne zaplatil.
Coinbase Commerce je jediná redirect brána v Ecommio, ktorá zákazníka nepresmerúva okamžite po výbere platby — na hostovanú stránku Coinbase odchádza až po jeho potvrdení priamo v pokladni.
Časté problémy
- Brána sa v pokladni nezobrazuje. Chýba API Key — doplňte ho v nastaveniach.
- Zákazník zaplatil, ale objednávka ostala nezaplatená. Skontrolujte Webhook Shared Secret — pri jeho chybe alebo výpadku notifikácie sa platba nikdy nepotvrdí automaticky.
- Testovacia platba sa spoplatnila reálne. Coinbase Commerce testovacie prostredie neponúka — každá platba, aj testovacia, je reálna. Na overenie webhooku bez platby použite simuláciu webhooku v Coinbase Commerce dashboarde.
- Potrebujete vrátiť peniaze zákazníkovi. Refundácia cez Ecommio nie je možná — vráťte prostriedky priamo mimo systému.