WordPress integration.

01composer require blockpay/woocommerce

01<?php
02// wp-content/plugins/my-shop/includes/class-wc-mycustom-blockpay.php
03use BlockPay\WooCommerce\Client;
04use BlockPay\WooCommerce\WooHelpers;
05
06class WC_MyCustomBlockPay_Gateway extends WC_Payment_Gateway {
07    public function __construct() {
08        $this->id                 = 'mycustom_blockpay';
09        $this->method_title       = 'Pay with USDC (custom)';
10        $this->has_fields         = false;
11        $this->supports           = ['products', 'refunds'];
12        $this->init_form_fields();
13        $this->init_settings();
14    }
15
16    public function process_payment($order_id) {
17        $order   = wc_get_order($order_id);
18        $bp      = new Client(get_option('blockpay_api_key'));
19        $invoice = $bp->createInvoice(
20            WooHelpers::orderToInvoiceInput($order)
21        );
22
23        $order->update_status(
24            'pending',
25            __('Awaiting BlockPay settlement.', 'my-shop')
26        );
27
28        return [
29            'result'   => 'success',
30            'redirect' => $invoice->checkoutUrl,
31        ];
32    }
33}

01<?php
02// wp-content/plugins/my-shop/includes/blockpay-webhooks.php
03use BlockPay\WooCommerce\Webhooks;
04
05add_action('rest_api_init', function () {
06    register_rest_route('my-shop/v1', '/blockpay-webhook', [
07        'methods'             => 'POST',
08        'permission_callback' => '__return_true',
09        'callback'            => 'my_shop_handle_blockpay_event',
10    ]);
11});
12
13function my_shop_handle_blockpay_event(WP_REST_Request $req) {
14    $raw       = $req->get_body();
15    $signature = $req->get_header('x_blockpay_signature') ?? '';
16
17    $verified = Webhooks::verify([
18        'raw_body'  => $raw,
19        'signature' => $signature,
20        'secret'    => get_option('blockpay_webhook_secret'),
21    ]);
22
23    if (!$verified) {
24        return new WP_REST_Response('bad signature', 401);
25    }
26
27    $event = json_decode($raw, true);
28    if ($event['type'] === 'invoice.paid') {
29        $order_id = $event['data']['metadata']['order_id'] ?? null;
30        if ($order_id) {
31            $order = wc_get_order((int) $order_id);
32            $order->payment_complete($event['data']['txHash']);
33        }
34    }
35
36    return new WP_REST_Response('ok', 200);
37}

01composer require blockpay/woocommerce

01<?php
02// Standalone use on a non-WooCommerce site:
03// a [blockpay_donate amount="25"] shortcode that
04// produces a checkout link without touching WC.
05use BlockPay\WooCommerce\Client;
06
07add_shortcode('blockpay_donate', function ($atts) {
08    $atts = shortcode_atts(['amount' => '10'], $atts);
09    $bp   = new Client(get_option('blockpay_api_key'));
10
11    $invoice = $bp->createInvoice([
12        'amount'          => (string) $atts['amount'],
13        'currency'        => 'USDC',
14        'chainKey'        => 'arc-testnet',
15        'merchantAddress' => get_option('blockpay_settlement_wallet'),
16        'description'     => 'Donation to ' . get_bloginfo('name'),
17    ]);
18
19    return sprintf(
20        '<a class="blockpay-donate-btn" href="%s">Donate %s USDC</a>',
21        esc_url($invoice->checkoutUrl),
22        esc_html($atts['amount'])
23    );
24});

01<?php
02// Manual signature verification, no SDK required.
03$raw    = file_get_contents('php://input');
04$sig    = $_SERVER['HTTP_X_BLOCKPAY_SIGNATURE'] ?? '';
05$secret = get_option('blockpay_webhook_secret');
06
07$expected = hash_hmac('sha256', $raw, $secret);
08if (!hash_equals($expected, $sig)) {
09    http_response_code(401);
10    exit('bad signature');
11}
12
13$event = json_decode($raw, true);
14// dispatch on $event['type']