Install our Plugin
On your WordPress admin page, hover over the 'Plugins' tab on the left sidebar, that will display a dropdown menu, within that dropdown click the 'Add New' tab. This will display the WordPress Plugin Directory, at the top of which there is a search bar. Simply type, 'QUID Payments' to find us.
Click the 'Install Now', which will then be swapped out with an 'Activate' button. Click 'Activate'.
The plugin is now ready for use!
Setup Your Merchant Account
Signup for a merchant account
Sign up for QUID and register for a new merchant account.
When you're done, you can always click the
Merchant button on the menu bar to get to the Merchant Dashboard.
Generate your API key and secret
- Go to the merchant dashboard (click the Merchant button on the menu bar.)
- Scroll down to the API Keys section and click Create a New API Key (or the + symbol if you have already created an API key). An API secret will also be generated for you.
- There are two types of API keys: test, and live. To create a key that can be used to accept real payments toggle the switch so that the text reads "New live API key"
- Add an origin for each website you want to use with this key. This must be a URL such as, https://example.com. Note that live keys must use https. To add an additional origin for the API key click on the ADD ORIGIN button and continue entering.
- When you are done entering origins, click on the CREATE button. Your new key and secret will be displayed as shown:
To learn more about API keys, see About your API keys.
Add QUID to WordPress
To start accepting QUID payments on your WordPress site you need to add the API keys to the plugin and configure each post for which you want to accept payments.
Add your QUID API keys to WordPress
Login to your WordPress admin dashboard and hover over the 'Settings' tab on the left sidebar, doing so will display a dropdown, within that dropdown select the 'QUID Payments' tab. Clicking it will lead you to the 'QUID Settings' page.
Enter the Public and Secret Keys acquired above. Note that the Secret Key is only visible once, when the API key is first created. If you don't know the Secret Key for the key you created, you'll have to make another.
Once you filled out the two fields with your keys, then press 'Save'. Next time you access the same page, the 'Secret Key' field will be blank (don't worry, unless you received an error message when saving it), the key is not shown to keep your account extra secure.
Post content and excerpt
Create your post content as you normally would. In order to display a sample of the post when the user hasn't paid, we utilize the 'Post Excerpt' field which can be found under 'Settings' - 'Document' on the same page where you write and edit your post. This can be the first few sentences of your post or any part of the post that you want to display to readers before purchasing.
When the 'Payment Type' is set to Required, the excerpt is the only thing that's shown, and once the content is paid for, the excerpt is removed and the whole post is shown in its place.
Setting the post payment options
Once our plugin is activated, if you navigate to the page where you Create/Edit a post, you'll notice a new section at the bottom of the page.
In this section you will specify all of the values our plugin needs. The values consist of the following:
Payment Type: Dropdown with the options, None, Required, and Optional.
- None: The post is not affected by the QUID Payments plugin.
- Required: Only the excerpt is shown until the content is purchased.
- Optional: The entire content is shown but the QUID payment options are displayed at the bottom of the post allowing the reader to donate or tip.
Input Type: Dropdown with the options Slider or Buttons.
- Slider: If the 'Payment Type' is set to Required and the 'Input Type' is set to Slider, the amount the user pays (between your max and min) is up to them, but they need to pay something in order to view more than the excerpt.
- Slider and Buttons: If the 'Payment Type' is set to Required, an 'Already Paid' button will also be rendered. If the user has previously purchased the content on the same computer, the content will load in place of the input, if they're on a different computer, they can select 'Already Paid' and sign-in and if they have in fact paid, the content will be rendered; otherwise they'll see a message saying "content not purchased".
Product Name: This can be anything and will be displayed along with the Product Description on the user's QUID dashboard under 'Payment History'. You can use the name of your blog here (e.g. Bram Stoker's Dracula).
Product Description: This can be anything and will be displayed along with the Product Name on the user's QUID dashboard under 'Payment History'. You can use the name of your blog post here (e.g. Chapter I).
Product ID: Can be anything, but must be unique! No two products can have the same 'Product ID'. This will not be displayed to the user but will be used to track if a post has already been paid for.
Product URL: A direct link to the product, this will also be shown of the user's QUID dashboard and provides a convenient way to return to their purchase. Use the WordPress permalink for the post.
Button Text: When the 'Input Type' is Slider, this is the text that will be displayed in the button. For the Buttons 'Input Type', the text defaults to Pay $...
Paid Text: The text that will appear in the button upon purchase. This is displayed for a few seconds before the payment section is removed from the post.
Price: This only needs to be set if 'Input Type' is set to Buttons. Set the value in dollars and cents (e.g. 0.23 for 23¢).
Min and Max Prices: These only need to be set if 'Input Type' is set to Slider and will be the slider's range. Set the value in dollars and cents (e.g. 0.23 for 23¢).
Initial Price: This only needs to be set if 'Input Type' is set to Slider and will be the value at which the slider is initially set. Set the value in dollars and cents (e.g. 0.23 for 23¢).
Test your post
When you preview your post you will see your QUID Button or Slider at the bottom of the post. If they stay greyed out it means the API keys you set in the 'QUID Settings' section of 'General Settings' were incorrect or that the origin you added to your API key when you created it does not match your site's address. If this happens, you should re-enter them. Make sure the origin you set for the API key on https://app.quid.works is the same as the address of your WordPress site.
At this point you are able to start accepting funds with QUID! If you have any questions, concerns, or comments, don't hesitate to reach out.