OwnPay WooCommerce Plugin Integration Guide for Stores

Customer Checkout
       │
       ▼
WooCommerce Order Created
       │
       ▼
OwnPay Plugin → POST /api/v1/payment-intents
       │
       ▼
Customer Redirected → OwnPay Checkout Page
       │
       ▼
Payment Completed / Failed
       │
       ▼
OwnPay Webhook → WooCommerce Order Status Updated

add_filter('ownpay_redirect_url', function (string $url, \WC_Order $order): string {
    return add_query_arg('ref', $order->get_order_key(), $url);
}, 10, 2);

add_filter('ownpay_payment_intent_payload', function (array $payload, \WC_Order $order): array {
    $payload['metadata']['wc_order_id']    = $order->get_id();
    $payload['metadata']['customer_note']  = $order->get_customer_note();
    return $payload;
}, 10, 2);

add_filter('ownpay_completed_order_status', function (string $status, \WC_Order $order): string {
    // Mark downloadable orders as completed immediately
    if ($order->has_downloadable_item()) {
        return 'completed';
    }
    return $status;
}, 10, 2);

// Performed automatically by the plugin on every incoming webhook:
$signature = hash_hmac('sha256', $rawBody, $webhookSecret);
if (!hash_equals($signature, $_SERVER['HTTP_X_OWNPAY_SIGNATURE'])) {
    status_header(401);
    exit('Invalid signature');
}

wp ownpay sync-order --order-id=1234

define('OWNPAY_VERIFY_SSL', false);