Payment Settings

Version 1.5.1 adds Pay to Post with PayPal. You can require a successful payment for each frontend submission, keep the new post in a pre-payment status, and automatically change its status after PayPal captures the payment.

Before you begin

Configure Sandbox or Live credentials, plus a default currency, in Global Settings. We recommend completing the whole workflow in PayPal Sandbox before accepting live payments.

Enable Pay to Post for a form

1. Open Frontend Post Submission Manager → Forms and edit the required form.
2. Open the form’s Payment tab.
3. Enable Enable Pay to Post (PayPal).
4. Configure the payment note, amount, currency, and post statuses described below.
5. Save the form.

Payment fields

• Show Payment Note: Displays a message on the frontend form when payment is required.
• Payment Note: Enter the message shown to the user. Use {amount} and {currency} to insert the configured charge dynamically.
• Amount: The charge for each submission. Leave it empty or set it to 0 to skip charging.
• Currency: Enter a supported three-letter currency code. Leave it blank to use the Default Currency from Global Settings.
• Post Status before Payment: The status assigned when the plugin creates the post but the PayPal payment is not yet complete.
• Post Status after Payment: The status assigned automatically after PayPal successfully captures the payment.

Customer payment flow

1. The user completes and submits the frontend form.
2. The plugin creates the post with the selected Post Status before Payment.
3. A PayPal payment button appears after the successful form submission.
4. The user approves the order in PayPal.
5. When PayPal confirms the capture, the plugin records the transaction and switches the post to the selected Post Status after Payment.

If payment is cancelled or capture does not complete, the post remains in its pre-payment status. This prevents an unpaid submission from being treated as paid or published unintentionally.

View payment records

Go to Frontend Post Submission Manager → Payments to review submission payments. The table shows the post, form alias, amount, currency, payment status, PayPal order ID, capture ID, payer email, and last updated time. Use the post link to review the related submission.

Troubleshooting

• The PayPal button does not appear: Confirm Pay to Post is enabled, the amount is greater than 0, and valid Client ID and Secret values are saved.
• PayPal rejects the credentials: Make sure the selected mode matches the credentials—Sandbox credentials for Sandbox mode and Live credentials for Live mode.
• The post stays in the pre-payment status: Check the Payments screen to confirm that capture completed successfully. A created or approved PayPal order is not the same as a completed capture.
• The currency is rejected: Use one of the supported PayPal currency codes listed in Global Settings.