REST API

Plugin registruje REST API endpointy pro komunikaci s platební bránou Comgate.

Základní informace

Namespace: wpify-woo/v1
Autentizace: Endpointy jsou veřejně přístupné (používají se pro webhooky)

Endpointy

POST /wpify-woo/v1/comgate

Webhook endpoint pro validaci stavu platby. Comgate volá tento endpoint při změně stavu platby.

URL: https://vasedomena.cz/wp-json/wpify-woo/v1/comgate

Parametry (POST):

Parametr	Typ	Popis
`transId`	string	ID transakce v Comgate
`refId`	string	ID objednávky
`status`	string	Stav platby (PAID, CANCELLED, PENDING, AUTHORIZED)

Odpověď:

code=0&message=OK - Úspěšné zpracování
code=1&message=Error - Chyba zpracování

GET /wpify-woo/v1/comgate/result

Endpoint pro přesměrování zákazníka po dokončení platby.

URL: https://vasedomena.cz/wp-json/wpify-woo/v1/comgate/result

Parametry (GET):

Parametr	Typ	Popis
`id`	string	ID transakce
`refId`	string	ID objednávky
`status`	string	Stav platby (paid, cancelled, pending)

Konfigurace v Comgate portálu

V administraci Comgate nastavte tyto URL adresy:

URL pro úspěšnou platbu

https://vasedomena.cz/wp-json/wpify-woo/v1/comgate/result?id=${id}&refId=${refId}&status=paid

URL pro zrušenou platbu

https://vasedomena.cz/wp-json/wpify-woo/v1/comgate/result?id=${id}&refId=${refId}&status=cancelled

URL pro čekající platbu

https://vasedomena.cz/wp-json/wpify-woo/v1/comgate/result?id=${id}&refId=${refId}&status=pending

URL pro ověření stavu

https://vasedomena.cz/wp-json/wpify-woo/v1/comgate/

Použití v kódu

Manuální kontrola stavu platby

/**
 * Kontrola stavu platby pomocí REST API
 */
$response = wp_remote_post(
    rest_url( 'wpify-woo/v1/comgate' ),
    array(
        'body' => array(
            'transId' => '123ABC',
            'refId'   => '456',
            'status'  => 'PAID',
        ),
    )
);

Získání order repository

// Získání objednávky podle trans_id
$container = \Starter\Container::getInstance();
$order_repo = $container->get( \WpifyWooComgate\Repositories\OrderRepository::class );
$order = $order_repo->find_by_trans_id( 'TRANS_ID_123' );

if ( $order ) {
    echo $order->get_comgate_status();
}