Business Accounts Router for GiveWP with PayPal Donations extends the GiveWP PayPal Donations gateway so that a single WordPress installation can accept donations through several PayPal Business accounts, automatically routing each transaction to the correct account based on the donor's declared country.<\/p>\n\n
This plugin is an independent, third-party extension. It is not affiliated with, endorsed by, or sponsored by GiveWP (StellarWP) or PayPal. The names \"GiveWP\" and \"PayPal\" appear here solely to describe compatibility with those products.<\/p>\n\n
This plugin is designed for organisations that operate two or more legally distinct charity entities \u2014 for example a US 501(c)(3) and a Canadian CRA-registered charity \u2014 that share a single donation website but must process payments through separate PayPal accounts and issue separate tax receipts.<\/p>\n\n
Key features:<\/strong><\/p>\n\n This plugin sends data to PayPal's REST API to authenticate with PayPal Business accounts and to verify the HMAC-SHA256 signatures of inbound webhook events.<\/p>\n\n PayPal REST API<\/strong> ( For detailed configuration instructions, see the OPERATIONS.md file included with the plugin.<\/p>\n\n\n This plugin supports the GiveWP PayPal Donations gateway (also known as PayPal Commerce \/ PPCP) only. It does not affect or support other GiveWP gateways such as Stripe, Authorize.net, or PayPal Standard.<\/p><\/dd>\n There is no hard limit on the number of PayPal Business accounts you can configure. Each account requires its own PayPal Developer REST app (Client ID and Client Secret) and its own webhook URL registered in PayPal's developer portal.<\/p><\/dd>\n Yes. PayPal Client IDs and Client Secrets are never stored in plaintext. They are encrypted with AES-256-GCM using a key derived via PBKDF2-SHA256 from your WordPress Yes. The plugin works with both PayPal sandbox and live environments. Add your sandbox accounts the same way as live accounts, using the Client IDs and Secrets from your sandbox REST apps. Register sandbox webhook URLs in PayPal's developer portal using a publicly accessible HTTPS URL (use a tunnelling tool such as ngrok for local development). See OPERATIONS.md for a full sandbox testing procedure.<\/p><\/dd>\n If no active routing rule exists for the selected country, the credential router falls back to GiveWP's primary PayPal account. The donation is not blocked \u2014 it proceeds normally using the default account. An error entry is written to the PHP error log with prefix No. The plugin hooks into GiveWP exclusively through WordPress filters, actions, and GiveWP's public IoC container ( Yes. The plugin registers additional GiveWP email template tags that you can insert into your existing GiveWP email templates (GiveWP \u2192 Settings \u2192 Emails). Tags include Verify that Added<\/strong><\/p>\n\n Security<\/strong><\/p>\n\n\n
[ador_country_selector]<\/code>) asks donors to identify their country before proceeding to checkout. Selection is stored in sessionStorage to avoid repeated prompts.<\/li>\n\/wp-json\/ador\/v1\/webhook\/{account_id}<\/code>) with independent HMAC signature verification.<\/li>\n$wpdb->prepare()<\/code> throughout.<\/li>\n<\/ul>\n\nExternal services<\/h3>\n\n
https:\/\/api-m.paypal.com<\/code>, https:\/\/api-m.sandbox.paypal.com<\/code>, https:\/\/api.paypal.com<\/code>, https:\/\/api.sandbox.paypal.com<\/code>)<\/p>\n\n\n
\/v1\/notifications\/verify-webhook-signature<\/code> endpoint for signature verification.<\/li>\n\n
alamin-donation-router<\/code> folder to the \/wp-content\/plugins\/<\/code> directory.<\/li>\ncomposer install --no-dev --optimize-autoloader<\/code> inside the plugin directory.<\/li>\nAUTH_KEY<\/code> and SECURE_AUTH_SALT<\/code> are set to strong, unique values in wp-config.php<\/code> \u2014 these are required for credential encryption.<\/li>\n[ador_country_selector]<\/code> to your donation landing page.<\/li>\n\n
Which payment gateways does this plugin support?<\/h3><\/dt>\n
How many PayPal accounts can I add?<\/h3><\/dt>\n
How are PayPal credentials stored? Is it safe?<\/h3><\/dt>\n
AUTH_KEY<\/code> and SECURE_AUTH_SALT<\/code> constants (100,000 iterations, 32-byte key). The random nonce and GCM authentication tag are stored alongside the ciphertext as a base64 blob. Credentials are never written to any log. If AUTH_KEY<\/code> or SECURE_AUTH_SALT<\/code> are changed, stored credentials become unreadable and must be re-entered.<\/p><\/dd>\nCan I test with PayPal sandbox accounts before going live?<\/h3><\/dt>\n
What happens if a routing rule is missing for a donor's country?<\/h3><\/dt>\n
[ADOR]<\/code> for the operator's attention.<\/p><\/dd>\nDoes this plugin modify GiveWP core files?<\/h3><\/dt>\n
give()<\/code>). No GiveWP core files are modified.<\/p><\/dd>\nCan I use this plugin with GiveWP's built-in email receipts?<\/h3><\/dt>\n
{paypal_account_entity_name}<\/code>, {paypal_account_entity_tax_id}<\/code>, {paypal_account_receipt_number}<\/code>, and four others. Tags return an empty string for donations not routed through this plugin, so existing templates work without changes.<\/p><\/dd>\nThe PDF receipt is not generating. What should I check?<\/h3><\/dt>\n
dompdf\/dompdf<\/code> is installed by running composer install<\/code> in the plugin directory. Confirm that the ador_pdf_receipts_enabled<\/code> option is set to a truthy value in wp_options<\/code>. Check the PHP error log for a line beginning [ADOR] PDF receipts disabled:<\/code> \u2014 this will include the underlying error message.<\/p><\/dd>\n\n<\/dl>\n\n\n1.0.0 - 2026-05-07<\/h4>\n\n
\n
{prefix}ador_accounts<\/code> and {prefix}ador_country_routing<\/code> with schema versioning.<\/li>\nPayPal_Credential_Router<\/code> intercepting GiveWP's IoC container before every PayPal AJAX payment request to substitute per-account credentials.<\/li>\nMerchantDetail::class<\/code> and MerchantDetails::class<\/code> covering all GiveWP PayPal credential resolution paths.<\/li>\nPOST \/wp-json\/ador\/v1\/webhook\/{account_id}<\/code> with HMAC-SHA256 signature verification and idempotency checking.<\/li>\n[ador_country_selector]<\/code> with sessionStorage persistence.<\/li>\nFOR UPDATE<\/code> lock.<\/li>\nador_pdf_receipts_enabled<\/code> option flag.<\/li>\nador_credentials_routed<\/code> and ador_webhook_processed<\/code>.<\/li>\n\n
current_user_can( 'manage_give_settings' )<\/code> capability checks on all admin-only actions.<\/li>\n$wpdb->prepare()<\/code> for all parameterised database queries.<\/li>\n<\/ul>","raw_excerpt":"Route GiveWP donations to multiple PayPal Business accounts by donor country. Multi-entity charities, automatic credential switching.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/311930","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=311930"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mralaminahamed"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=311930"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=311930"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=311930"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=311930"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=311930"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=311930"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}