Přejít k obsahu
QR code to Stripe paymentsDokumentace QR2Stripe

← Všechny návody

Propojení s pluginy WordPressu

Vývojáři mohou z jiného pluginu na stejném webu vytvářet platby a reagovat na ověřené platební události.

Platbu vytvořte pomocí qr2stripe_create_payment; částka je v nejmenších jednotkách měny a reference označuje vaši objednávku. Referenci opatřete vlastním prefixem, aby se nekřížila s jinými pluginy. Uložte ID vrácené platby a později ji načtěte pomocí qr2stripe_get_payment; neexistující platba vrátí null. Adresu platební stránky vrací qr2stripe_payment_page_url.

Akce: qr2stripe_payment_created dostane uloženou platbu; qr2stripe_payment_cancelled platbu zrušenou v administraci; qr2stripe_payment_paid platbu a Stripe PaymentIntent po ověření webhooku; qr2stripe_payment_mismatch původní platbu, PaymentIntent a seznam nesouladů; qr2stripe_duplicate_payment platbu a druhý PaymentIntent.

Hooky běží synchronně a nejsou frontou se zaručeným doručením. Události zpracovávejte idempotentně a chyby dohledávejte podle uloženého ID platby. Expiraci vypočítá QR2Stripe_Store::effective_status a sama nespustí akci. Řádky plateb obsahují tokeny a PaymentIntent údaje Stripe; nezveřejňujte je. Samotné hooky neposílají data do jiných služeb.

// Call this from your order flow, once the order is ready for payment.
function myplugin_create_payment() {
    if (!function_exists('qr2stripe_create_payment')) return;
    $payment = qr2stripe_create_payment([
        'amount' => 12900, // 129.00 CZK
        'currency' => 'czk',
        'reference' => 'myplugin-order-123',
    ]);
    if (!is_wp_error($payment)) {
        $payment_id = $payment['id']; // Store this with your order.
        $url = qr2stripe_payment_page_url($payment);
    }
}

add_action('qr2stripe_payment_paid', function ($payment, $payment_intent) {
    // Match your order by reference and mark it paid idempotently.
}, 10, 2);