Payment Plug-ins

This is a documentation about CrowdFunding Payment Plug-ins. These extensions provide functionality people to make donations via payment gateways. These plug-ins also receive and process transaction data from the gateways.

All payment plug-ins contains a section "Notification E-Mails" where the administrator should select notification and confirmation e-mail templates. Those templates will be used from the system to generate and send e-mails to the project owner, backer and administrator.

Notification E-Mails

Send mail to administrator - This is an e-mail template that will be used from the system to generate and send notification mail to the administrator when someone makes a donation.

Send mail to creator - This is an e-mail template that will be used from the system to generate and send notification mail to the owner of the project when someone makes a donation.

Send mail to user - This is an e-mail template that will be used from the system to generate and send confirmation mail to the user, which has made a donation.

E-Mail Mode - This is a format in which will be sent the e-mails to their receivers.

Placeholders

This is a list with placeholders that you can use in email templates that will be send by the payment plugins.

{SITE_NAME} - The name of your website.

{SITE_URL} - The URL of your website. Example: http://itprism.com/

{ITEM_TITLE} - Name of an item (article, campaign, product, project, etc.)

{ITEM_URL} - URL to an item.

{AMOUNT} - Amount that has been donated to a campaign.

{TRANSACTION_ID} - Transaction ID that is associated with a payment.

{PAYER_EMAIL} - E-mail of a person who has made a payment.

{PAYER_NAME} - Name of a person who has made a payment.

{SENDER_EMAIL} - E-mail address of a person from whom will be sent the email.

{SENDER_NAME} - Name of a person that sends the email.

{RECIPIENT_EMAIL} - E-mail address of a person to whom the email will be sent.

{RECIPIENT_NAME} - Name of a person who will receive an email.

{REWARD_TITLE} - Title of the reward selected by a person who makes payment.

{DELIVERY_DATE} - Estimated date for delivering the reward.

AuthorizeNet

This is a plugin that provides functionality for making a payment via Authorize.Net. It uses Direct Post Method to process the transaction.

Options

API Login ID and Transaction Key - Your API Login ID and Transaction Key are unique pieces of information specifically associated with your payment gateway account. These two values are only required when setting up an Internet connection between your e-commerce Web site and the payment gateway.

IMPORTANT: The API Login ID and Transaction Key protect your payment gateway account from unauthorized use and should not be shared with anyone.

MD5 Hash - The MD5 Hash security feature allows you to authenticate transaction responses from the payment gateway. You may establish a unique MD5 Hash value that the payment gateway will use when encrypting responses for transactions submitted for your account.

Live URL - This is a URL where the system will send user data.

Return URL - This is a URL where AuthorizeNet will redirect the baker when he completes his payment.

Notify URL - This is a URL where AuthorizeNet will send information about processed transaction and its status.

Display Fields - This option enables viability of the form field that will be displayed on your website. The user have to fill this fields.

Display Info - This option displays an additional information about payment process.

Sandbox

Sandbox is a test tool for developers that provide accounts on test servers where you will be able to make payments without real money. You will be able to test the payment process and to receive transaction data. When you are done with tests, and you are ready to move to the production services, you must disable the sandbox.

NOTE: AuthorizeNet only works with USD in sandbox mode.

Enable Sandbox - Enable or disable the sandbox.

Sandbox URL - This is a URL where the system will send "fake" data.

Screenshots

Bank Transfer

This is a payment plugin that provides functionality for making payments via bank transfer. This extension registers a payment and generates a transaction ID that gives to the user. The user has to go to a bank office and to make a bank transfer using this transaction ID as a description/note for the transaction.

Options

Beneficiary - Information about the receiver of the funds - name, address, IBAN, SWIFT,...

Return URL -This is a URL where the person should be redirected when he registers his payment.

Auto Complete -This option will store the transaction as completed automatically, if you set it to "Yes."

Display Info - Display or not an additional information about what to do the user.

Additional Information - This is a form element where you are able to enter additional information, which will be displayed on the payment page.

Screenshots

Blockchain

This is a plugin that add functionality for making Bitcoin payments via Blockchain.

Options

Receiving Address - Bitcoin address where you will receive payments.

Callback URL - URL address to the script where Blockchain servers will send information about payments.

Test Mode

This is a state which will allow you to make fictitious payments. Thus, you will be able to test the system before you make it available to all users.

Enable Test Mode - option to enable or disable the test mode.

Screenshots

Blockchain payment

Coinbase

This is a plugin that add functionality for making Bitcoin payments via Coinbase.

Options

API Key and SecretAPI Key and Secret are credentials that will give permissions to the crowdfunding platform to do some actions with your Coinbase account.

Test Mode

The test mode is a tool for developers whom will use to process fictitious payments via Coinbase. Use this option to test the payment process before move to production server.

When you enable the test mode, the system will generate a custom string on step "Pay" of the payment wizard. You have to copy and paste that string in the field "Custom String."

To make a transaction, you have to go to your account on Merchant Settings. You have to enter callback URL and click on the button "Test Now". That will send fictitious transaction data to your script.

Enable Test Mode - This option enables and disables the test mode.

Custom String - This is a string that crowdfunding platform generates and sends to Coinbase servers when the user make a payment.

Test Amount - This is an amount that you would like to be accounted when the system receive a notification from Coinbase.

Advanced Options

Return URL - This is a URL where Coinbase will redirect the baker when he completes his payment.

Cancel URL - This is a URL where Coinbase will redirect the user when he cancels his payment.

Callback URL - This is a URL where the Coinbase servers will send a notification and information about transaction when the user completes his payment.

Auto Redirect - This option enables automatic redirection of a user to next step of the payment wizard.

Button Type - This is the type of the button - Buy Now or Donate.

Button Style - This is the style of the button.

Button Text - This is the text that should be placed over a button.

Screenshots

Mollie iDEAL

This is a plugin that enables iDEAL payments via Mollie.

Options

Partner ID - This is an identification key for merchants with Mollie accounts. You will find it in your account.

Return URL - This is a URL where Mollie will redirect the baker when he completes his payment.

Notify URL - This is a URL where Mollie will send information about transaction and its status.

Test Mode

The test mode is a tool for developers whom will use to process fictitious payments via Mollie. You can use this option to test payments process before move to live server.

Enable Test Mode - This option enables or disables the test mode.

Screenshots

PayPal Standard

This plug-in will be installed with the package of the crowdfunding platform. It adds functionality for making payments via PayPal Standard. The payments will be processed immediately and the money will be transferred instantly to your account or to the account of the campaign owner.

Options

Merchant ID - The Merchant ID is an alternative to using your email address in non-hosted or non-encrypted item button code. When you open a PayPal Account, this ID is assigned to your account automatically. You have to enter a Merchant ID or your e-mail address in this field.

PayPal URL - This is a URL to PayPal service where the system will redirect the user to make a payment.

Return URL - This is a URL where PayPal will redirect the baker when he completes his payment.

Cancel URL - This is a URL where PayPal will redirect the baker when he cancel his payment.

Notify URL - This is callback URL where PayPal will send information about transaction and its status.

Country - This is a country where your service operates. Depending from this option, the system will display a button in local language and will send the user to a local server.

Sandbox

The PayPal Sandbox is a self-contained, virtual testing environment that mimics the live PayPal production environment. It provides a shielded space where you can initiate and watch your application process the requests you make to the PayPal APIs without touching any live PayPal accounts.

Here you are some additional information about PayPal testing environment.

Enable Sandbox - This option enables and disables the test mode. When you are ready for the production server, you must disable sandbox environment.

Sandbox Merchant ID - The Sandbox Merchant ID is an alternative to using your email address and it is only active for sandbox account.

Sandbox URL - This is a URL to PayPal testing service where the system will send user data.

Advanced Options

Logo URL - This is a link to your logo that will be displayed on the shopping cart on PayPal site.

Use Default Button - This option enables a function that displays default PayPal button. When you select a country by the above option, the system will generate a button in local language. However, sometimes this button cannot be generate and you should display the default button.

Button Type - This is the type of the button that will be displayed.

Button URL - This is a URL to a button, that you would like to be displayed. When you select a country by the above option, the system will generate button in local language. However, sometimes this button will not be generate and you  will be able to provide a link to your one. If you would like, you can generate a button and get the link to the picture from the following pages.

Load Certificate - This option tells to the system to load own certificate when receive and validates transaction data during the process of notification by PayPal. You will find the certificate in the folder of PayPal in Prism Library.

Payment Receiver - This option sets who must collect payments - the company of the site owner or the project owner. If you select site owner, the system will send money in an account provided by this plugin. If you select project owner, the system will send money in an account, provided by the project owner. The campaign owner will be able to give his PayPal account, when you install CrowdFunding Finance and enable the plugin "CrowdFunding - Payout Options".

Screenshots

PayPal Express

This plug-in enables functionality for making payments via PayPal Express. The payments will be processed as a preapproval order. When campaign completes, you will be able to capture or void transactions. If you capture the transaction, the money will be sent to your account. Then, you should calculate your fees and send other amount to the owner of the project.

Options

Merchant ID - The Merchant ID is an alternative to using your email address in non-hosted or non-encrypted item button code. When you open a PayPal Account, this ID is assigned to your account automatically. You have to enter a Merchant ID or your e-mail address in this field.

API Username - This is one of the credentials used to connect and identify yourself to PayPal servers, during the process of making transactions via web services.

API Password - This is a password used to identify yourself to servers.

API Signature - This is a unique string used to identify yourself to PayPal servers.

Country - This is a country where your service operates. Depending from this option, the system will display a button in local language and will send the user to a local server.

Sandbox

The PayPal Sandbox is a self-contained, virtual testing environment that mimics the live PayPal production environment. It provides a shielded space where you can initiate and watch your application process the requests you make to the PayPal APIs without touching any live PayPal accounts.

Here you are some additional information about PayPal testing environment.

Enable Sandbox - This option enables and disables the test mode. When you are ready for the production server, you must disable sandbox environment.

Sandbox Merchant ID - The Sandbox Merchant ID is an alternative to using your email address and it is only active for sandbox account.

Sandbox API Username - A credentials used for identifying yourself to servers that are used for testing.

Sandbox API Password - Password used for identifying your transaction to test servers.

Sandbox API Signature - Unique string used for identifying yourself to PayPal test servers.

Sandbox URL - URL to servers for testing where the system will redirect users to make payments.

Sandbox API URL - URL where your system will make a request to web services when it is in test mode.

Advanced Options

PayPal Live URL - URL to PayPal service where the system will redirect the user to make a payment.

PayPal API URL - URL where your system will make a request to PayPal API, processing a real transaction.

Return URL - URL where PayPal will redirect the baker when he completes his payment.

Cancel URL - URL where PayPal will redirect the baker when he cancel his payment.

Notify URL - Callback URL where PayPal will send information about transaction and its status.

Do Checkout URL - Callback URL where the user will be redirected when he makes a payment. That is a method used from the system to process DoExpressCheckoutPayment .

Logo URL - This is a link to your logo that will be displayed on the shopping cart on PayPal site.

Use Default Button - This option enables a function that displays default PayPal button. When you select a country by the above option, the system will generate a button in local language. However, sometimes this button cannot be generate and you should display the default button.

Button Type - This is the type of the button that will be displayed.

Button URL - This is a URL to a button, that you would like to be displayed. When you select a country by the above option, the system will generate button in local language. However, sometimes this button will not be generate and you  will be able to provide a link to your one. If you would like, you can generate a button and get the link to the picture from the following pages.

Load Certificate - This option tells to the system to load own certificate when receive and validates transaction data during the process of notification by PayPal. You will find the certificate in the folder of PayPal in Prism Library.

Screenshots

PayPal Adaptive

This plug-in enables functionality for making payments via PayPal Adaptive. The payments will be processed as preapproval. When campaign completes, you will be able to capture or cancel transactions. If you capture the transaction, the money will be sent to your account or to the account of the project owner. There three ways to process transactions - simple, parallel or chained. It is possible to set up fees which will be calculated and sent to your account. PayPal Adaptive is one of the best options to manage crowdfunding transactions.

Options

Receiver e-mail - It is an e-mail of a person who is going to receive amounts. This receiver could be treated as a primary receiver or as a second one.

If you select a "Payment Type" to be Simple, the receiver will be treated as a primary receiver. The system will send all money to his account.

If you select a "Payment Type" to be Parallel or Chained, the receiver will be treated as second receiver. The system will send all money to project owner account, but the fees will be sent to the account of the second receiver. You have to use CrowdFunding Finance and enable the plugin CrowdFunding - Payout Options. That will provide functionality the project owners to give their PayPal accounts. Those accounts will be treated as a primary receiver in Parallel and Chained payment type.

Application ID - This is the identification of your application that will perform transactions.

API Username - This is one of the credentials used to connect and identify yourself to PayPal servers, during the process of making transactions via web services.

API Password - This is a password used to identify yourself to servers.

API Signature - This is a unique string used to identify yourself to PayPal servers.

Country - This is a country where your service operates. Depending from this option, the system will display a button in local language and will send the user to a local server.

Sandbox

The PayPal Sandbox is a self-contained, virtual testing environment that mimics the live PayPal production environment. It provides a shielded space where you can initiate and watch your application process the requests you make to the PayPal APIs without touching any live PayPal accounts.

Here you are some additional information about PayPal testing environment.

Enable Sandbox - This option enables and disables the test mode. When you are ready for the production server, you must disable sandbox environment.

Sandbox Receiver e-mail - It is an e-mail of a person who is going to receive amounts in test mode. This receiver could be treated as a primary receiver or as a second one.

Sandbox Application ID - The Sandbox contains a unique and static App ID (APP-80W284485P519543T). When you move an application into production, PayPal assigns your application a custom App ID that you need to use to key your application with the production servers.

Sandbox API Username - A credentials used for identifying yourself to servers that are used for testing.

Sandbox API Password - Password used for identifying your transaction to test servers.

Sandbox API Signature - Unique string used for identifying yourself to PayPal test servers.

Sandbox URL - URL to servers for testing where the system will redirect users to make payments.

Sandbox API URL - URL where your system will make a request to web services when it is in test mode.

Advanced Options

PayPal Live URL - URL to PayPal service where the system will redirect the user to make a payment.

PayPal API URL - URL where your system will make a request to PayPal API, processing a real transaction.

Return URL - URL where PayPal will redirect the baker when he completes his payment.

Cancel URL - URL where PayPal will redirect the baker when he cancel his payment.

Notify URL - Callback URL where PayPal will send information about transaction and its status.

Use Default Button - This option enables a function that displays default PayPal button. When you select a country by the above option, the system will generate a button in local language. However, sometimes this button cannot be generate and you should display the default button.

Button Type - This is the type of the button that will be displayed.

Button URL - This is a URL to a button, that you would like to be displayed. When you select a country by the above option, the system will generate button in local language. However, sometimes this button will not be generate and you  will be able to provide a link to your one. If you would like, you can generate a button and get the link to the picture from the following pages.

Load Certificate - This option tells to the system to load own certificate when receive and validates transaction data during the process of notification by PayPal. You will find the certificate in the folder of PayPal in Prism Library.

Starting Date - This option sets a starting date when you will be able to capture payments.

  • Registration Date - you will be allowed to perform transactions from a date, when they have been registered in the system.
  • Campaign End - you will be allowed to perform transactions after the the end date of the campaign.

Payment TypePayment type is the way in which PayPal is going to perform payments.

  • Simple payments - enable a sender to send a single payment to a single receiver. To use this option, you have to enter a payment receiver in this plugin. That will be the primary receiver.
  • Parallel payments - enable a sender to send a single payment to multiple receivers. To use this option:
    • You have to install CrowdFunding Finance and enable the plugin "CrowdFunding - Payout Options". That will add a form on the fifth step of the project wizard, and the form will be used from project owners to store their e-mail (PayPal account). The e-mail will be the primary receiver.
    • You have to set up fees on the options of CrowdFunding Finance.
    • You have to enter a second receiver here in the plugin.
  • Chained payments - enable a sender to send a single payment to a primary receiver. The primary receiver keeps part of the payment and pays secondary receivers the remainder. To use this option you have to do same things like the configuration for Parallel Payments, mentioned above.

Fees Payer - This options sets the payer of the PayPal fees.

  • sender – Sender pays all fees (for personal, implicit simple/parallel payments; do not use for chained or unilateral payments)
  • primary receiver – Primary receiver pays all fees (chained payments only)
  • each receiver – Each receiver pays their own fee (default, personal and unilateral payments)
  • secondary only – Secondary receivers pay all fees (use only for chained payments with one secondary receiver)

Screenshots

Stripe

This plug-in enables payments via Stripe using Embedded Form method. Your users will be charged instantly.

Options

Secret Key - the secret key will be used for all API calls to Stripe services on server-side. You will find it in your Stripe account.

Publishable Key - this key will be used to generate credit card tokens and should be included with the HTML form.

Display Info - enables displaying of additional information about payment process.

Additional Information - information that you would like to provide to the user who is going to make payment.

Callback URL - This is a URL where Mollie will redirect the baker when he completes his payment.

Test Mode

In test mode, credit card transactions don't go through the actual credit card network — instead, they go through simple checks in Stripe to validate that they look like they might be credit cards. In test mode you can use any combination of credit card data that passes these simple checks, discussed more on our testing page.

Test Secret Key - the test secret key will be used for all API calls to servers for testing.

Test Publishable Key - this key will be used to generate credit card tokens and should be included with the HTML form. This key will be recognized only from servers for testing payment transactions.

Advanced

Some additional options that will help you to customize the payment process.

Company Name - The name of your company or website.

Image - A relative URL pointing to a square image of your brand or product. The recommended minimum size is 128x128px. The recommended image types are .gif, .jpeg, and .png.

Panel Label - The label of the payment button in the Checkout form (e.g. “Subscribe”, “Pay {{amount}}”, etc.). If you include {{amount}}, it will be replaced by the provided amount. Otherwise, the amount will be appended to the end of your label.

Button Label -The text to be shown on the default blue button.

Validate Zip Code -Specify whether Checkout should validate the billing ZIP code.

Include Remember Me -Specify whether to include the option to "Remember Me" for future purchases.

Screenshots

Stripe payment plugin

Stripe Connect

This plug-in enables payments via Stripe Connect. Using this option for payment, the project owner will be able to connect his account to your Stripe platform. 

When someone would like to make a donation, the system will create a "card" record to the platform. When campaign completes successfully, you will be able to capture or void transactions.

If you capture the transaction, the system will send the money to the project owner account and fees to your Stripe platform account. If you void transactions, the system will remove registered earlier "cards" from your platform.

Requirements

You have to install Crowdfunding Finance because you have to enable its plugin Crowdfunding - Payout Options. You will have to enter secret key, publishable key and client ID in the options of the extension.

You have to enable project wizard in six steps because the plugin Crowdfunding - Payout Options will be displayed on step "Extras".

How does it work?

  1. Project owner connects its Stripe account to your Stripe platform via Crowdfunding - Payout Options.
  2. When someone makes payment, your platform will register a transaction.
  3. When a campaign completes, you will have to capture or void those transactions using the transaction manager on your crowdfunding platform.
    • If you capture a transaction, your Stripe platform will transfer the money in the project owner account and fees in your account.
    • If you void a transaction, the system will delete the pre-authorized transaction from your Stripe platform.

Options

Advanced

Some additional options that will help you to customize the payment process.

  • Additional Information - Write information that you would like to provide to the user who is going to make donation.
  • Company Name - The name of your company or website.
  • Image - A relative URL pointing to a square image of your brand or product. The recommended minimum size is 128x128px. The recommended image types are .gif, .jpeg, and .png.
  • Panel Label - The label of the payment button in the Checkout form (e.g. “Subscribe”, “Pay {{amount}}”, etc.). If you include {{amount}}, it will be replaced by the provided amount. Otherwise, the amount will be appended to the end of your label.
  • Button Label -The text to be shown on the default blue button.
  • Validate Zip Code -Specify whether Checkout should validate the billing ZIP code.
  • Include Remember Me -Specify whether to include the option to "Remember Me" for future purchases.

Stripe Connect payment plugin

How to configure Stripe Connect?

  1. Install Crowdfunding Finance and enable its plugin Crowdfunding - Payout Options.
  2. Enable the plugin Crowdfunding - Payout Options. You will have to enable Stripe Connect by its options. There is an option Redirect URL that you will have to copy and paste in the platform.
  3. Go to your Stripe account and register a platform on your dashboard.
  4. Copy the redirect URL from Crowdfunding - Payout Options and paste it in the field Redirect URIs on the platform.
  5. Open Crowdfunding Finance options and select tab Stripe Connect. Enter Client ID, Secret Key and Publishable Key. You will find them in your Stripe account settings. You will find the client ID on the page of the platform and the secret key and publishable key in tab API keys.
  6. Enable the plugin CrowdfundingPayment - Stripe Connect.

How to test payment process?

Stripe provides development environment where you can test payment process without real money. There is a button on your dashboard that you should use to switch your Stripe account to test mode.

I strongly recommend you to create several Stripe accounts that you will be able to use to test the payment process.

  • Corporate account - that will be your business account. You will register the platform in this account. The system will use it to manage transactions and collect fees.
  • Merchant account - use that account to connect project owner to the platform. That account will receive the money from a campaign.
  • Customer account - that account will be used to make payments. You will find a list with credit card numbers and bank accounts for testing on the page with information about testing.

Follow next steps to test the payment process:

  1. Go to step "Extras" on project wizard and connect the merchant account to the platform as project owner.
  2. Make payment using the customer account.
  3. Go to your crowdfunding platform administration, section "Transactions" and capture the transaction.

WePay

This is a plug-in that enables payments via WePay using iFrame form method.

Options

Account ID - Your account ID is the globally unique ID of your account. You will find it on your WePay account dashboard.

Access Token - An access token is a unique string of letters and numbers that you pass with every API call, so WePay knows that you have authorization to make that call.

Client ID - The client ID is a unique identifier of your application. You will find it on your dashboard.

Client Secret -This is a secret value (password) for your API application.

Return URL - URL where WePay will redirect the baker when he completes his payment.

Notify URL - This is a URL where WePay will send information about transaction and its status.

Display Info - This option enables displaying of additional information about payment process.

Use Custom Certificate - If there is a problem with the SSL certificate, you can try a custom one. Enable this option to use the custom SSL certificate. You can find more information about the problem with SSL on https://support.wepay.com.

Staging

The staging is a tool for developers who will use to process fictitious payments via WePay. They will be able to use this option for test payments process before move to a production server.

Enable Staging - This option enables or disables the staging mode.

Staging Access Token - This is an access that you pass with every API call to a staging server.

Screenshots


Free Subscription

You can get the latest publication via RSS, Twitter or Facebook. And I can also deliver last news to you for free via Email:

RSS subscription Find us on Facebook Google+ page Follow me