Ako integrovať Payout platobnú bránu do WooCommerce (2025)

V tomto technickom návode vám ukážeme, ako krok za krokom integrovať platobnú bránu Payout do vášho WooCommerce e-shopu. Celý proces zvládnete za menej ako 30 minút — aj bez programátorských skúseností.

Krok 1: Registrácia Payout účtu

Prvým krokom je vytvorenie účtu na app.payout.one/signup. Registrácia je zadarmo a trvá približne 5 minút.

1. Vyplňte registračný formulár — meno, e-mail, názov firmy a IČO
2. Potvrďte e-mailovú adresu kliknutím na odkaz v doručenom e-maily
3. Doplňte firemné údaje a nahrajte potrebné dokumenty
4. Payout tím schváli váš účet — zvyčajne do 72 hodín

Krok 2: Stiahnutie a inštalácia WooCommerce pluginu

Payout ponúka oficiálny WooCommerce plugin, ktorý celú integráciu zautomatizuje:

1. Prihláste sa do WordPress administrácie vášho e-shopu
2. Prejdite do Pluginy → Pridať nový
3. Vyhľadajte „Payout" alebo „Payout Payment Gateway"
4. Kliknite na Inštalovať a následne Aktivovať

$ wp plugin install payout-payment-gateway --activate
Installing Payout Payment Gateway...
Plugin installed successfully.
Activating 'payout-payment-gateway'...
Plugin 'payout-payment-gateway' activated.

Krok 3: Nastavenie API kľúčov v administrácii

Po aktivácii pluginu je potrebné prepojiť ho s vaším Payout účtom pomocou API kľúčov:

1. V Payout Dashboard prejdite do Nastavenia → API kľúče
2. Skopírujte Client ID a Client Secret
3. Vo WordPress prejdite do WooCommerce → Nastavenia → Platby → Payout
4. Vložte API kľúče do príslušných polí
5. Uložte zmeny

define('PAYOUT_CLIENT_ID', 'váš_client_id');
define('PAYOUT_CLIENT_SECRET', 'váš_client_secret');
define('PAYOUT_ENVIRONMENT', 'sandbox'); // alebo 'production'

Krok 4: Testovanie v sandbox prostredí

Pred spustením ostrej prevádzky odporúčame dôkladne otestovať integráciu v sandbox (testovacom) prostredí:

1. V nastaveniach Payout pluginu prepnite na Sandbox režim
2. Použite testovacie API kľúče z Payout Dashboard (sekcia Sandbox)
3. Vytvorte testovaciu objednávku vo vašom e-shope
4. Dokončite platbu pomocou testovacej karty
5. Overte, že objednávka bola správne spracovaná a stav sa zmenil na „Zaplatené"

Číslo karty:  4200 0000 0000 0000
Expirácia:    12/2030
CVV:          123
Meno:         Test User

// Úspešná platba → stav objednávky: "Processing"
// Zamietnutá platba: použite CVV 999

Krok 5: Spustenie ostrej prevádzky

Keď je testovanie úspešné, prepnite bránu do produkčného režimu:

1. V Payout Dashboard vygenerujte produkčné API kľúče
2. Vo WordPress nahraďte sandbox kľúče produkčnými
3. Prepnite režim z Sandbox na Production
4. Vykonajte jednu reálnu testovaciu platbu (napr. za 1 €)
5. Hotovo! Váš e-shop teraz prijíma skutočné platby cez Payout

Manuálna API integrácia (pre developerov)

Ak preferujete vlastnú implementáciu alebo používate custom WooCommerce tému, môžete použiť Payout REST API priamo:

$response = wp_remote_post('https://api.payout.one/api/v1/checkouts', [
    'headers' => [
        'Authorization' => 'Bearer ' . $access_token,
        'Content-Type'  => 'application/json',
    ],
    'body' => json_encode([
        'amount'      => $order->get_total() * 100, // suma v centoch
        'currency'    => 'EUR',
        'external_id' => $order->get_id(),
        'redirect_url' => $return_url,
        'notification_url' => $webhook_url,
        'payment_methods' => ['card', 'bank_button', 'apple_pay'],
    ]),
]);

$checkout = json_decode(wp_remote_retrieve_body($response));
// Presmerovanie zákazníka na checkout URL
wp_redirect($checkout->checkout_url);

// functions.php alebo vlastný plugin
add_action('rest_api_init', function() {
    register_rest_route('payout/v1', '/webhook', [
        'methods'  => 'POST',
        'callback' => 'handle_payout_webhook',
    ]);
});

function handle_payout_webhook($request) {
    $payload = $request->get_json_params();
    $order = wc_get_order($payload['external_id']);
    
    if ($payload['status'] === 'successful') {
        $order->payment_complete($payload['id']);
    }
    
    return new WP_REST_Response(['status' => 'ok'], 200);
}

Časté problémy a ich riešenie