Aulaa for WooCommerce
| 开发者 | aulaa |
|---|---|
| 更新时间 | 2026年11月2日 16:44 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Aulaa is an Indonesian payment gateway that lets any business accept QRIS, Virtual Account, e-wallet and retail (Alfamart/Indomaret) payments from one merchant account, with payouts to 114+ Indonesian banks. This plugin connects your WooCommerce store to it.
This plugin integrates Aulaa as a payment method in WooCommerce. When a customer checks out, a payment link is created in Aulaa and the customer is taken to it, where they pick a payment method (QRIS, GoPay, ShopeePay, bank Virtual Account, Alfamart/Indomaret, etc.) and follow the payment instructions. Aulaa then returns them to the order page. Aulaa is a payment link provider, so your store never receives or stores raw payment credentials such as Virtual Account numbers or QRIS payloads — only the link. Order status is set solely by Aulaa's webhook and by the plugin's own status polling, never by the customer's browser.
Features:
- Supports both classic checkout (shortcode) and Checkout Blocks (React).
- Multi-Currency Support: Stores operating in foreign currencies (USD, SGD, EUR, JPY, MYR, AUD, etc.) can accept payments via Aulaa. Order totals are automatically converted to Rupiah (IDR) before creating the invoice.
- Flexible Exchange Rate Modes: Choice between Manual Fixed Rates (default, merchant-controlled) with friendly human-readable format, or automated daily live rates with built-in sanity checks, circuit breakers, and automatic fallback.
- Configurable Markup Buffer (%): Protects merchants against market volatility and foreign exchange conversion costs.
- Direct Checkout Payment Method Selection: Optionally let customers pick a specific payment method (QRIS, BCA VA, BRI VA, Mandiri VA, BNI VA, E-Wallets, Retail, etc.) directly on the checkout page using Aulaa's live methods API (
GET /v1/payments/methods). - Order Cancellation Synchronization: Automatically cancels pending invoices at Aulaa (
POST /v1/payments/{id}/cancel) when an order is cancelled in WooCommerce. - Self-Updating Order Status: After paying, the customer lands back on the Order Received page, which reports the new order status as soon as a webhook or the plugin's status polling confirms the payment — no manual refresh, and the browser never decides the status.
- 409 Conflict Smart Recovery: Automatically recovers from network dropouts during checkout by retrieving the existing invoice
payment_idwithout failing customer checkouts. - Refund Status Support: Automatically marks orders as refunded when a refund is processed in Aulaa.
- Sandbox Simulation Tools: Quick links to the Aulaa payment simulator from the WordPress admin order page.
- Recurring Subscriptions Engine: Built-in subscription manager for periodic billing. Set products as recurring (daily, weekly, monthly, yearly), automatically generate renewal orders and invoices on due dates via Action Scheduler, and notify customers via email with direct Aulaa payment links.
- Customer Subscription Portal: Customers can view and manage their subscriptions, view due dates, pay pending renewal invoices, and cancel subscriptions directly in WooCommerce My Account.
- Admin Subscription Management: Full admin dashboard under WooCommerce → Langganan Aulaa with cycle tracking, notes history, manual bill now actions, and status controls.
- Background Auto-Polling: Automatically queries Aulaa's API every 10 minutes via Action Scheduler for pending orders to reconcile payments if webhooks are delayed or blocked.
- HPOS (High-Performance Order Storage) compatible.
- HMAC-SHA256 webhook verification — fraudulent notifications are rejected.
- Idempotent: duplicate notifications do not process an order twice.
- "Check payment status at Aulaa" button on the order edit page (manual reconciliation if a webhook is delayed or missing).
- Optional debug logging to WooCommerce → Status → Logs (source "aulaa").
- Transaction limits: Rp1.000 - Rp500.000.000 per invoice.
- Create a free Aulaa account - no monthly fee, pay per transaction.
- Transaction fees and pricing
- API documentation for developers and step-by-step guides
- WooCommerce integration guide
安装:
- Create an Aulaa merchant account if you do not have one yet, then create a project in the Aulaa dashboard.
- Upload the
aulaa-for-woocommercefolder towp-content/plugins/, or install via Plugins → Add New → Upload. - Activate the plugin from the Plugins menu.
- Go to WooCommerce → Settings → Payments → Aulaa (or click "Settings" in the plugin list).
- Enable the gateway and fill in:
- API Key — from your Aulaa dashboard → Project.
- Webhook Secret — from the same Aulaa project.
- Copy the Callback / Webhook URL displayed on the settings page and paste it as the Callback URL in your Aulaa project.
- Make sure the WooCommerce store currency is set to IDR (or enable "Konversi Mata Uang" under Multi-Currency settings if your store uses USD, SGD, EUR, JPY, etc.).
常见问题:
Do I need an Aulaa account to use this plugin?
Yes. The plugin is a bridge to the Aulaa payment gateway, so payments are processed by Aulaa. Create a merchant account at aulaa.co, open a project, then copy its API Key and Webhook Secret into the plugin settings. Fees are listed on the pricing page.
Which payment methods can my customers use?
QRIS (all Indonesian QRIS-enabled apps), bank Virtual Accounts (BCA, BRI, Mandiri, BNI and more), e-wallets such as GoPay and ShopeePay, and retail outlets Alfamart and Indomaret. The current list is served live by the Aulaa API; see aulaa.co for what is available on your account.
Where is the API documentation?
The full REST API reference is at aulaa.co/dokumentasi, and setup guides are at aulaa.co/panduan.
Why is the Aulaa payment method not showing at checkout?
Make sure: (1) the gateway is enabled, (2) an API Key is entered, and (3) the store currency is set to IDR or "Konversi Mata Uang" is enabled with exchange rates configured for your store currency.
Order is paid but status is still "pending"?
Check that the Callback URL in your Aulaa project is correct and that the Webhook Secret in the plugin exactly matches the one in your Aulaa dashboard. Webhooks with a mismatched signature are rejected. To fix a single order manually, open the order, select "Check payment status at Aulaa" from the Order actions dropdown, then click Update — the plugin will query Aulaa directly and update the order status.
Is customer card data stored on my store?
No. Customers pay on the Aulaa-hosted page; your store never receives card data.
Why is the Virtual Account number or QR code no longer shown in my store?
Aulaa is a payment link provider, so raw payment credentials stay on the Aulaa payment page. Since 2.2.0 the plugin never requests, stores or displays Virtual Account numbers or QRIS payloads. It shares the payment link instead, which opens in a new tab and shows the customer the available methods and the instructions for the one they pick. Numbers stored by earlier versions are removed from order meta automatically in the background. Order status is unaffected — it is still set by Aulaa's webhook and by the plugin's status polling.
更新日志:
2.2.3
- Fix: logo metode pembayaran di checkout klasik tidak lagi tampil sebesar ukuran asli berkasnya. WooCommerce merender ikon gateway apa adanya, sehingga satu logo bisa muncul setinggi ratusan piksel sementara tetangganya hanya beberapa piksel dan daftar metodenya berantakan. Semua logo Aulaa kini disamakan tingginya dan dirapatkan ke kanan, di checkout klasik maupun Checkout Blocks.
- Fix: logo yang sebelumnya tampil hitam-putih kini berwarna sesuai mereknya. Berkas CIMB Niaga, GoPay, DANA, LinkAja, Indomaret, dan Maybank memakai
currentColor, yang di dalam tag<img>selalu jatuh ke hitam karena SVG-nya dokumen terpisah dan tidak mewarisi warna halaman. - New: tujuh saluran yang ada di Aulaa tetapi tidak pernah didaftarkan plugin kini tersedia — BSI, BTN, bank bjb, Danamon, Sinarmas, Artha Graha, dan Bank Sahabat Sampoerna Virtual Account. Saluran yang belum aktif di project merchant tetap tidak ditawarkan, karena ketersediaannya diperiksa ke daftar metode live.
- Fix: Kartu Kredit / Debit kini juga terdaftar di WooCommerce Checkout Blocks. Sebelumnya saluran ini hanya ada di checkout klasik, sehingga toko yang memakai Blocks tidak pernah bisa menampilkannya. Slot kartunya memakai lambang jaringan Visa, Mastercard, dan JCB, dan metodenya tampil di urutan pertama.
- Change: ShopeePay memakai berkas logo yang benar. Berkas sebelumnya adalah logo Shopee biasa dalam susunan tegak, yang pada baris metode pembayaran menyusut jadi noktah.
- Tweak: daftar saluran pembayaran kini ditulis satu kali saja (
WC_Aulaa_Sub_Gateway::get_channels()) dan dipakai bersama oleh checkout klasik, Checkout Blocks, dan penjadwal langganan. Empat salinan terpisah sebelumnya sempat berbeda isi, dan itulah sebab kartu kredit hilang dari Blocks.
- Fix: membayar ulang pesanan yang sama — lewat tombol "Bayar" di daftar pesanan atau halaman bayar order — tidak lagi menerbitkan tagihan kedua secara membabi buta. Plugin kini menanyakan dulu nasib tagihan yang sudah ada: bila sudah lunas statusnya langsung diterapkan tanpa tagihan baru, bila masih menunggu dengan metode dan nominal yang sama tautannya dipakai ulang, dan bila memang harus diganti tagihan lamanya dibatalkan di Aulaa.
- Fix: webhook kini juga mengenali ref percobaan bayar yang sudah digantikan. Sebelumnya menimpa
_aulaa_order_refmembuat notifikasi untuk tagihan lama ditolak diam-diam dengan HTTP 200 — Aulaa menganggapnya terkirim dan tidak mengulang — sementara auto-polling hanya melihat tagihan terbaru. Akibatnya pembayaran ke tautan lama bisa masuk tanpa pesanan pernah ditandai lunas, tanpa jalur pemulihan otomatis apa pun. - Change: pembeli kembali diarahkan langsung ke halaman pembayaran Aulaa di tab yang sama, lalu dikembalikan Aulaa ke halaman pesanan setelah membayar. Membuka tab baru dari halaman pesanan menuntut satu klik tambahan karena pemblokir pop-up, dan alur satu tab ini lebih singkat.
- Tweak: panel halaman pesanan kini fokus pada dua keadaan yang benar-benar terjadi — baru kembali dari Aulaa sebelum webhook mendarat, atau pembayaran yang ditinggal lalu dibuka lagi — dengan status yang memperbarui diri dan satu tautan untuk melanjutkan pembayaran.
- Fix: saluran pembayaran yang tidak dilayani project Aulaa milik merchant tidak lagi muncul di checkout. Sebelumnya validasi ke daftar metode live dilewati setiap kali nominal keranjang tidak diketahui — halaman bayar order dan tautan bayar perpanjangan termasuk di dalamnya — atau ketika daftar metode kosong, sehingga seluruh sub-gateway tampil dan
POST /paymentsditolak 400 "metode pembayaran tidak tersedia" setelah pembeli selesai mengisi formulir. - Fix: validasi ketersediaan saluran yang sama kini berlaku di WooCommerce Checkout Blocks, yang sebelumnya tidak memeriksanya sama sekali.
- Fix: Kartu Kredit / Debit (
credit_card) kini tersedia sebagai metode mandiri di checkout. Saluran ini dilayani API Aulaa tetapi belum punya sub-gateway, sehingga pada mode "Pisahkan per Metode" tidak pernah bisa dipilih pembeli meski aktif di project merchant. - Fix: metode yang nominal keranjangnya di luar batas min/max tidak lagi ditawarkan. Sebelumnya, bila tidak ada satu pun metode yang cocok, daftar tak tersaring yang dikembalikan sehingga kegagalannya hanya berpindah ke
POST /payments. - Tweak: metode tanpa field
is_availablepada respons API diperlakukan sebagai tersedia, dan daftar metode yang tersaring habis dicatat ke log WooCommerce agar perubahan bentuk respons API langsung terlihat.
- Compliance: Aulaa berperan sebagai penyedia payment link, bukan payment gateway, sehingga nomor pembayaran mentah (nomor Virtual Account dan payload QRIS) tidak lagi disimpan maupun ditampilkan oleh plugin. Yang dipegang dan dibagikan toko hanya tautan pembayaran.
- Compliance: Nomor pembayaran mentah yang tersimpan di meta order oleh versi sebelumnya dibersihkan otomatis per batch di latar belakang lewat Action Scheduler. Pencocokan webhook dan rekonsiliasi tidak terpengaruh karena keduanya memakai id invoice dan order ref, bukan nomor pembayaran.
- Compliance: Penghapusan ketergantungan pada layanan pihak ketiga QR Server (api.qrserver.com). Payload QRIS tidak pernah lagi dikirim keluar dari toko.
- Change: Tautan pembayaran Aulaa dibuka di tab baru. Setelah menekan "Buat pesanan", pelanggan tetap berada di halaman Terima Kasih toko alih-alih dilempar keluar dari toko.
- Change: Panel halaman Terima Kasih kini menampilkan tautan pembayaran beserta indikator status yang diperbarui sendiri. Status dibaca dari server; webhook dan polling tetap satu-satunya penentu status pembayaran, dan browser pelanggan tidak pernah menentukannya.
- Enhancement: Polling status on-demand dari halaman Terima Kasih, dibatasi satu panggilan API per 15 detik per pesanan, sehingga pembayaran terkonfirmasi tanpa menunggu siklus auto-polling 10 menit.
- Tweak: Semua tautan pembayaran Aulaa di wp-admin, portal langganan pelanggan, dan email tagihan perpanjangan dibuka di tab baru dengan
rel="noopener".
- Feature: Multi-Currency Support — toko dengan mata uang selain IDR (USD, SGD, EUR, MYR, JPY, AUD, dll.) kini dapat menggunakan gateway pembayaran Aulaa. Total pesanan otomatis dikonversi ke Rupiah (IDR) sebelum invoice diterbitkan.
- Feature: Pilihan mode penentuan kurs: Kurs Manual (Fixed Rate, default/utama) dengan parser input fleksibel, serta opsi otomatis dari Live Exchange Rate API yang dilengkapi Sanity Check (Circuit Breaker) dan auto-fallback ke kurs manual.
- Feature: Pengaturan Buffer Markup Kurs (%) yang dapat disesuaikan oleh merchant untuk mengantisipasi selisih kurs riil dan biaya valas.
- Enhancement: Tampilan estimasi konversi mata uang yang transparan bagi pembeli di formulir checkout klasik dan WooCommerce Checkout Blocks.
- Enhancement: Penyimpanan audit trail konversi mata uang lengkap (mata uang asal, nominal asli, nilai kurs, mode kurs, dan nominal IDR) pada metadata pesanan dan metabox detail pesanan admin.
- Notice: Penambahan disclaimer tanggung jawab finansial dan hukum pada setelan gateway admin.
- Feature: Menghadirkan mode "Pisahkan per Metode" (Individual Gateways) — QRIS, Virtual Account (BCA, Mandiri, BNI, BRI, CIMB, Permata, dll.), E-Wallet (ShopeePay, GoPay, OVO, DANA), dan Retail tampil langsung sebagai pilihan utama mandiri di checkout WooCommerce tanpa radio button bersarang ("pilihan di dalam pilihan").
- Feature: Kontrol masing-masing metode di WooCommerce → Pengaturan → Pembayaran untuk mengaktifkan/menonaktifkan, mengubah judul, dan mengatur urutan tampilan.
- Enhancement: Tampilan baru mode satu gateway ("Pilih di Checkout") menggunakan grid kartu visual interaktif responsif dengan logo resmi tanpa radio button lingkaran ganda.
- Enhancement: Dukungan sub-gateway untuk WooCommerce Checkout Blocks (React).
- Fix: Sinkronisasi pembatalan otomatis, auto-polling 10 menit, dan aksi order admin sekarang mencakup semua transaksi dari sub-gateway Aulaa.
- Feature: Tampilan baru pemilihan metode pembayaran langsung di checkout dengan daftar kartu vertikal rapi, radio button di kiri, dan logo resmi bank/e-wallet di kanan (BCA, Mandiri, BNI, BRI, CIMB, Permata, QRIS, DANA, OVO, ShopeePay, dll.).
- Feature: Integrasi aset logo bank dan metode pembayaran resmi.
- Tweak: Penghapusan opsi dropdown fleksibel pada mode "Pilih di Checkout" agar pembeli langsung memilih metode spesifik.
- Tweak: Peningkatan batas timeout pemanggilan endpoint
/v1/payments/methodsuntuk performa render checkout yang lebih cepat.
- Fix: webhook execution order updated to process payment completion and save order status to database before returning HTTP 200 OK response, preventing premature script termination on LiteSpeed and FastCGI servers.
- Fix: fixed custom post type capability conflict where registering
aulaa_subscriptionhijacked themanage_woocommercecapability, causing admin sidebar menus (WooCommerce Payments, Meta WhatsApp) to disappear and triggering a 403 permission error on WooCommerce Settings. - Docs: the plugin page now links to the Aulaa homepage, pricing, API documentation, guides and sign-up, so merchants can reach account setup from the plugin listing.
- Docs: added FAQ entries covering account setup, supported payment methods and where the API documentation lives.
- Docs: shortened the one-line description, which was over the 150-character limit and was being cut off in the WordPress.org listing.
- Tweak: Plugins → Installed Plugins now shows Aulaa website, documentation and support links in the plugin row.
- Tweak: the API credentials section of the gateway settings links straight to the Aulaa dashboard and sign-up page.
- Fix: refund status from Aulaa was never applied — the "already paid" guard returned before the refund branch could run, so
refundedwebhooks were silently ignored. - Fix: removed an
admin_posthook registered to a method that was never defined, which produced a fatal error for any logged-in user who reached that URL. - Fix: auto-polling fetched the oldest pending orders and then discarded ones older than three days, so abandoned checkouts could fill the batch and starve recent orders. The age limit is now applied in the query.
- Fix: failed payment-method lookups are now cached briefly. Previously, an unreachable Aulaa API made every checkout page render wait on a 30-second HTTP timeout.
- Fix: HTTP 409 recovery now reads back the invoice's original order reference. Previously it stored a freshly generated reference that the webhook could never match, leaving paid orders stuck as pending.
- Fix: renewal invoices validate the same Rp1.000 - Rp500.000.000 bounds as checkout.
- Fix: dates are rendered with
wp_date(), so stores in time zones observing DST display the correct local time. - Fix:
label_countfor subscription statuses no longer passes variables to_n_noop(). - Fix: uninstall now also removes the payment-method cache and any leftover renewal locks.
- Feature: payment method selection (QRIS, VA, E-Wallet, Retail) now also works on Checkout Blocks, not just classic checkout.
- Feature: the renewal notification is now a proper
WC_Email— configurable under WooCommerce > Settings > Emails, with theme-overridable templates and a plain-text version. - Docs: declared the QR Server (goqr.me) image API under External services.
- Housekeeping: removed a stray plugin zip archive that was being shipped inside the plugin.
- Major release: Advanced Aulaa API integration and Recurring Subscriptions v2.
- Feature: Direct payment method selection at checkout (QRIS, VA, E-Wallet, Retail) via live API (
GET /v1/payments/methods). - Feature: Order cancellation synchronization with Aulaa API (
POST /v1/payments/{id}/cancel). - Feature: Fallback payment instructions on WooCommerce Thank You / Order Received page (QRIS QR Code & Virtual Account with 1-click copy button).
- Feature: Smart recovery from HTTP 409 Conflict during checkout retries.
- Feature: Refund status synchronization (
refunded). - Feature: Transaction amount bounds validation (Rp1.000 - Rp500.000.000).
- Feature: Sandbox simulation shortcuts in WordPress Admin Order screen.
- Feature: Recurring subscriptions engine for periodic billing via Aulaa payment link invoices.
- Feature: Product-level subscription settings (interval, period, number of cycles).
- Feature: Action Scheduler automated renewal processing with lock protection.
- Feature: Automatic renewal order creation and email notifications with direct payment links.
- Feature: Customer self-service subscription portal under WooCommerce My Account.
- Feature: Admin subscription dashboard under WooCommerce → Langganan Aulaa.
- Feature: Background auto-polling every 10 minutes to query Aulaa API for pending orders.
- Fix webhook timeout (send early HTTP 200 OK response with fastcgi_finish_request before processing order and background hooks).
- Initial release: Aulaa gateway (classic checkout + Blocks), signed webhooks, HPOS.
- Order action "Check payment status at Aulaa" (manual reconciliation via GET /payments/{id}).
- Optional debug logging to WooCommerce Logs (credentials are never stored in logs).