Интеграция с плагинами WordPress
Разработчики могут создавать платежи и обрабатывать проверенные события из другого плагина того же сайта WordPress.
Создайте платёж через qr2stripe_create_payment; сумма задаётся в минимальных единицах, reference обозначает заказ. Используйте свой префикс, чтобы избежать конфликтов. Сохраните ID и получите платёж через qr2stripe_get_payment; при отсутствии возвращается null. qr2stripe_payment_page_url возвращает адрес страницы оплаты.
События: qr2stripe_payment_created получает сохранённый платёж; qr2stripe_payment_cancelled платёж, отменённый в админке; qr2stripe_payment_paid платёж и Stripe PaymentIntent после проверки webhook; qr2stripe_payment_mismatch прежний платёж, PaymentIntent и ошибки; qr2stripe_duplicate_payment платёж и второй PaymentIntent.
Хуки выполняются синхронно и не гарантируют доставку. Обрабатывайте события идемпотентно и восстанавливайте ошибки по сохранённому ID. QR2Stripe_Store::effective_status вычисляет истечение срока без события. Платежи содержат токены, а PaymentIntent данные Stripe; не публикуйте их. Хуки сами не отправляют данные в другие сервисы.
// 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);