Vytvořte si účet Cost+, otestujte svou první platbu na sandboxovém webu a připravte svou integraci pro ostré platby.
Než začnete
Budete potřebovat:
- Přístup k Obchodnímu portálu Cost+
- Aplikaci běžící na serveru nebo podporovanou eCommerce platformu
- Bezpečné místo pro uložení API klíčů mimo klientský kód a veřejné repozitáře
1. Vytvořte si účet
Vytvořte si účet Cost+ a poté se přihlaste do Obchodního portálu. Portál je místo, kde spravujete weby, platební metody, API přihlašovací údaje, transakce a webhooky.
2. Vytvořte sandboxový web
V Obchodním portálu otevřete sekci Websites a vytvořte sandboxový web. Sandboxový web vám umožní testovat bez přesunu skutečných peněz.
Cost+ používá stejnou základní API URL pro sandbox i produkci. Režim určuje web připojený k vašemu API klíči.
3. Zkopírujte své API údaje
Otevřete svůj sandboxový web a vyberte Integration. Zkopírujte API klíč a Merchant ID do své konfigurace na straně serveru.
Nikdy ne zveřejňujte API klíč v kódu prohlížeče, mobilní aplikaci, snímcích obrazovky, zprávách podpory ani ve veřejném repozitáři.
4. Vyberte si cestu integrace
| Vaše konfigurace | Doporučená cesta |
|---|---|
| Shopify, WooCommerce, Magento nebo jiná podporovaná platforma | Začněte s průvodci pro pluginy a integrace. |
| Vlastní web, který by měl přesměrovat zákazníky na zabezpečený platební formulář | Použijte Hostovaný platební formulář (Hosted Payment Page). |
| Plně vlastní integrace na straně serveru | Postupujte podle rychlého startu API Cost+. |
5. Proveďte sandboxovou platbu
Použijte základní API URL https://api.costplus.online/v1 s API klíčem sandboxového webu.
Pro úspěšnou testovací platbu kartou použijte:
- Číslo karty:
4111 1111 1111 1111 - Platnost: jakékoli budoucí datum
- CVC: libovolné tři číslice
Testovací čísla karet fungují pouze s sandboxovými údaji. Viz Testování vaší integrace pro karty s odmítnutou platbou a běžné validační chyby.
6. Potvrďte výsledek platby
Potvrďte, že objednávka se zobrazuje v Obchodním portálu a dosáhla očekávaného stavu. U vlastní integrace ověřte výsledek prostřednictvím API Cost+ nebo webhooku před vyřízení objednávky.
Nepovažujte přesměrování prohlížeče zákazníka za důkaz platby.
7. Příprava na ostrý provoz
Než začnete přijímat skutečné platby:
- Dokončete požadovaný onboarding a underwriting pro produkční web.
- Potvrďte, že jsou zapnuto všechny platební metody, které potřebujete.
- Nahraďte sandboxový API klíč klíčem produkčního webu ve své zabezpečené konfiguraci na straně serveru.
- Potvrďte, že vaše URL adresy pro návrat, chybu a webhooky používají HTTPS a směřují do produkčního prostředí.
- Proveďte kontrolovanou ostrý platbu a ověřte její konečný stav před otevřením pokladny pro zákazníky.
Potřebujete pomoc?
Přečtěte si dokumentaci pro vývojáře Cost+ nebo kontaktujte podporu Cost+.