Description
RedFace Pay for WordPress connects your site to the RedFace Platform via Commerce API.
- One login — same merchant identity across every RedFace plugin
- Modular — only Payments loads in this release
- Connection wizard — account, API key, business, ready
- Webhooks — require a configured secret and
x-redface-signatureHMAC verification - Shortcode —
[redface_pay_button amount="99.00" currency="ZAR"]
You are not installing a standalone payment gateway. Business logic lives on RedFace; this plugin is a thin, secure client.
Configuration
- Merchant ID — UUID of your RedFace business
- API Key —
rf_live_…from Account Developers (never commit to version control) - Webhook URL — copy from Settings into your RedFace webhook dashboard
- Mode — Sandbox for testing, Live for production
External services
This plugin connects to the RedFace Commerce API to create payment sessions and receive webhooks.
What is sent and when
- When a customer pays, the plugin sends your configured Merchant ID and authenticates with your API key (stored in WordPress options).
- Payment payloads may include amount, currency, customer email, and order metadata.
- A connection test (
ping) runs when you complete the connection wizard or test settings in wp-admin.
Default API endpoint
https://bpzzgilwlkghgfkvkkxx.supabase.co/functions/v1/commerce-api
Merchants may override the API base URL in plugin settings (e.g. for staging).
Service provider
RedFace (RedFace Pay), African commerce infrastructure.
- Terms of use: https://www.redfacepay.co.za/legal/terms
- Privacy policy: https://www.redfacepay.co.za/legal/privacy
Troubleshooting
- API Status offline — verify API key, merchant ID, and that your key is active in RedFace Account.
- Webhooks failing — confirm webhook secret matches Settings and your site is reachable over HTTPS.
- Pay button does nothing — complete the Connection wizard and confirm payments scope on your API key.
Support
Email support@redfacepay.co.za or visit https://www.redfacepay.co.za/plugins/redface-pay
Installation
- Upload the plugin folder to
/wp-content/plugins/redface-payor install from WordPress.org (when published). - Activate through the Plugins screen.
- Open RedFace Pay Connection and complete the wizard.
- Generate an API key at https://www.redfacepay.co.za (Account Developers).
FAQ
-
Does this replace WooCommerce?
-
No. Use RedFace Pay for WooCommerce for Woo checkout. This plugin is for simple pay buttons and custom themes.
-
Where is business logic?
-
On RedFace Platform — payments, settlement, KYC, and events. The plugin never embeds payment partner secrets in WordPress.
-
Does this store card data in WordPress?
-
No. Checkout runs on RedFace hosted payment pages.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“RedFace Pay” is open source software. The following people have contributed to this plugin.
Contributors
Translate “RedFace Pay” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.2
- Plugin Check: prefix admin view variables; sanitize wizard API key input for WordPress.Security rules.
1.0.1
- Settings: API keys and webhook secrets are sanitized without sanitize_text_field so token characters are preserved.
- Webhooks: require a configured webhook secret and a valid x-redface-signature; reject unsigned requests.
1.0.0
- Initial release — connection wizard, Commerce API client, pay button shortcode, webhooks, admin logs.