feature-image-buycred

Built-in( free )

Current Version: 1.4
Requires: myCRED 1.0 or higher

about-transfer

Let your users buy any number of point types for real world currencies using popular online payment processors!

The buyCRED Add-on creates and deposits points into your users account once they have made a successfully payment to any of the supported payment gateways. You can set how much points cost, how many users can buy and even offer a custom exchange rate on a user by user basis!

Buying Points

Users buy points via one of the two shortcodes that the add-on provides. You can either set the amount and gateway yourself or lets users select how many points to buy and / or which gateway to use. buyCRED supports 5 payment gateways out of the box: PayPal Payments Standard, Skrill, NETBilling, Zimbaio and Bitpay.

Management

The buyCRED add-on brings you vast range of tools to help you manage purchases. You can have a dedicated admin page where you can view a purchase history, set exchange rates for individual users and manage pending payments.

Frequently Asked Questions

  • Can users convert points back into a currency?
    No. myCRED does not offer a withdrawal system. If you are comfortable with PHP, it can be done with ease but it is not a feature that myCRED includes.
  • What is Sandbox Mode?
    Sandbmox mode is used when you want to make test purchases using the buyCRED add-on. This way you can make test purchases to make sure everything works or if you have issues, troubleshoot what the issue might be. If you do not want to make test purchases make sure Sandbox Mode is disabled!
  • When buying Points using PayPal, can I use any email address?
    Yes, buyers can pay using any PayPal email address when purchasing points on your site.

Related Tutorials

myCRED.me members can buy Tokens at any time via their profiles. Simply login and visit the “Tokens” page under your profile. Here you can select “Buy Tokens” in the sub-menu.

On this page, I am using the mycred_buy shortcode multiple times for each gateway. This is one example of how you can let users buy a specific amount of points.

mycred-topup-tokens

The Purchase Process

buycred-step1

Step 1

A user visits a page or post where you have inserted a shortcode and if allowed, selects the amount of points to buy and optionally the payment processor to use.

buycred-step2

Step 2

The user is redirected to the myCRED Checkout Page which will calculate the cost, validate the purchase request and make sure the the selected payment gateway is correctly setup.

buycred-step3

Step 3

The buyer is either redirected to the payment processors server where they can make the payment or if the gateway supports it, process the users payment details on your website.

buycred-step4

Step 4

If the gateway supports automatic updates (most do) the processor will inform your website when a payment has been completed. myCRED will listen to these calls and credit the users account with points once a notification is verified.

Installation Guides

The following installation guides only cover the payment processors this add-on supports. The installation guides for premium gateways can be found by visiting each individual product page.

Add-on Setup

  1. Go to the myCRED > Add-ons page in your admin area.
  2. Click on the “buyCRED” title in the list.
  3. Click on the “Enable” button.
  4. Go to the myCRED > Settings page and click on the “buyCRED” title to show the add-ons default settings.
  5. Adjust the default settings to your needs and click “Update Settings” on the bottom of the page to save.
  6. Go to the myCRED > Payment Gateways page.
  7. Click on the title of each Gateway that you want users to be able to choose from when purchasing points, and make sure you enter all required fields.
  8. At this point, the buyCRED add-on is ready for purchases! In order for your users to buy points, you will need to insert one of the following shortcodes on your website:
    • mycred_buy
      This shortcode can be used when you want users to purchase a preset number of points to a preset user (for example the content author). Please consult the codex for examples and available options for this shortcode.
    • mycred_buy_form
      This shortcode is a more advanced version of mycred_buy allowing users to select the amount they want to buy,which gateway to use for the purchase and optionally (if you allow it) purchase points for other members. Please consult the codex for examples and available options for this shortcode.
    • mycred_buy_pending
      This shortcode will show either a given users or the current user viewing the shortcodes pending purchases.
  9. Done!

A red gateway icon indicates that the gateway is not used, Orange indicates that the Sandbox Mode is active and Green indicates that the gateway is active and ready.

Make sure you only have Sandbox Mode enabled when testing the payment gateway. Once you have finished your tests, make sure you disable it.

Disabling the Add-on

  1. Go to the myCRED > Add-ons page in your admin area.
  2. Click on the “buyCRED” title in the list.
  3. Click on the “Disable” button.
  4. Remove the shortcodes from your theme.
  5. Done!

Adjust a users exchange rate

  1. Locate the user in question in your admin area and click to edit their account.
  2. In the top bar on the User Editor page click on the name of the point type you want to adjust the exchange for.
  3. Here, scroll down to the bottom and set the custom exchange rate for this point type. This rate will only be applicable to this user.
  4. To remove a custom exchange rate, remove the exchange rate in the field and save.
  5. Save
buycred-paypal16

Setup the Payment Gateway

  1. Go to the myCRED > Payment Gateways page in your admin area.
  2. Click on “PayPal Payments Standard” in the list to view your settings.
  3. Select to enable the payment gateway.
  4. Select the currency to use with this gateway.
  5. Enter your PayPal Account Email.
  6. Change “Item Name” to what you want buyers to see when they pay. You can use the %number% template tag to show the amount of points a user will buy and this field also supports general template tags. Note that this field can not be empty!
  7. Set an exchange rate between your points and the currency you selected. By default this will be 1:1.
  8. Save.

As of version 1.6, you no longer need to set the Instant Payment Notifications URL for PayPal. This information are now passed on to PayPal via the purchase form.

buycred-bitpay16

Setup the Payment Gateway

  1. Go to the myCRED > Payment Gateways page in your admin area.
  2. Click on “Bitpay (Bitcoins)” in the list to view your settings.
  3. Select to enable the payment gateway.
  4. Enter your Bitpay API Key.
  5. Enter the thee character currency code you want to use with this gateway.
  6. Change “Item Name” to what you want buyers to see when they pay. You can use the %number% template tag to show the amount of points a user will buy and this field also supports general template tags. Note that this field can not be empty!
  7. Set an exchange rate between your points and the currency you selected. By default this will be 1:1.
  8. Select your Transaction Speed. If High is selected, the user will gain the points as soon as the payment is completed. If you prefer that points are paid first when the amount has been confirmed in your Bitpay account (bitcoin block updated) then select Low.
  9. Select if you want full notifications. Recommended to be set to “Yes”.
  10. Save.

It is recommended that you create a separate API key for buyCRED instead of using an existing one (if you use Bitcoin in other plugins on your website as well e.g. WooCommerce).

buycred-netbilling16

Setup the Payment Gateway

  1. Go to the myCRED > Payment Gateways page in your admin area.
  2. Click on “NETBilling” in the list to view your settings.
  3. Select to enable the payment gateway.
  4. Enter your Account ID.
  5. Enter your Site Tag.
  6. Enter your Order Integrity Key from your NETBilling account. This can be found on the “Fraud Defence” page under Step 12. Make sure the “Enforce order integrity checkbox is checked!
  7. Change “Item Name” to what you want buyers to see when they pay. You can use the %number% template tag to show the amount of points a user will buy and this field also supports general template tags. Note that this field can not be empty!
  8. Set an exchange rate between your points and USD. By default this will be 1:1.
  9. Copy the Postback CGI URL address given to you.
  10. Save.
  11. Login to your NETBilling account and edit your site in the Site list by selecting “Configure”. Scroll down till you find “Postback CGI URL” and paste in the address.
  12. Save.
  13. Save.

For increased security, it is highly recommended that you change your Order Integrity key every now and then. You can change it under “Fraud Defence” by generating a new one. Remember to update your myCRED Payment Gateway settings to use this newly generated key instead of the old one!

netbilling-oik

The Fraud Defence setup page where you enable and create a unique Order Integrity Key. This key will ensure that notifications from NETBilling can always be validated.

Setup the Payment Gateway

  1. Go to the myCRED > Payment Gateways page in your admin area.
  2. Click on “Skrill (Moneybookers)” in the list to view your settings.
  3. Select to enable the payment gateway.
  4. Select the currency you want to use with this gateway.
  5. Enter your merchant account email address.
  6. Enter your secret word. You can set your secret word under “Merchant Tools” in your Skrill Account.
  7. Change “Item Name” to what you want buyers to see when they pay. You can use the %number% template tag to show the amount of points a user will buy and this field also supports general template tags. Note that this field can not be empty!
  8. Set an exchange rate between your points and the currency you selected. By default this will be 1:1.
  9. Select if you want to receive a confirmation email on each purchase.
  10. Finally you can change how your Skrill checkout page looks and what information is shown. You can also leave these empty to use your default setup in Skrill.
  11. Save.

By default all Skrill Merchant account accept payments via Bank Transfers. When a user selects this option, no points are awarded! You will need to manually award these once the bank transfer is completed.

By default purchases made using Skrill will result in users having to signup for a Skrill account (if they do not have one already). You can contact Skrill Merchant Services and request to disable this feature.

buycred-zombaio16

Setup the Payment Gateway

  1. Go to the myCRED > Payment Gateways page in your admin area.
  2. Click on “Zombaio” in the list to view your settings.
  3. Select to enable the payment gateway.
  4. Enter your Site ID.
  5. Enter your GW password
  6. Enter your Pricing ID
  7. Enter a logo URL you want to use on the checkout page
  8. Select if you want to use the IP Verification which will force buyCRED to only accept callbacks from the Zombaio server IPs.
  9. Select the language you want to use for the checkout page.
  10. Login to your Zombaio account and enter the URL given to your for your ZScript.
  11. Save.
  12. Go back to your Zombaio account and test the ZScript. If all is set correctly, you should get a success message.

Premium Gateways

  • buycred-payza
  • buycred-wepay
  • buycred-payfast
  • buycred-stripe
  • mycred-coinpayments
  • buycred-coinbase
  • buycred-robokassa
  • buycred-2co
  • mycred-compropago