Payments

By default UNA has Payment App with PayPal and Stripe integrations in it. This App is used to process subscriptions and single time payments via shopping cart. For example, default UNA's Permissions (via Paid Levels App) and Market App are integrated with Payments App. So, if you want to sell something in Market or sell Paid membereship levels on your site you need to start from setting up the Payment App.

1. First of all you need to install Payments App via Studio -> Apps Market.
2. When the App was installed you need to find Payments App in the Studio home page and open it. You may change the default currency for your site there. Also it has 'Site administrator' setting. It's essential to assign some Personal profile as site administratior if you plan to sell Paid membership levels. This profile will be used as seller for paid levels. You may use your Administrator account here.
3. Now you need to go to User End and configure necessary payment providers. You may do it via Account popup -> Orders -> Settings. Note. If you decided to use a separate profile for 'Site administrator' described in point #2 then you need to configure payment providers for both sellers (Market seller and Paid Levels seller) separately.
4. On the settings page you may see about six payment providers but currently only two of them are fully functional. They are PayPal and Stripe.

Configuring PayPal:

Open the PayPal slider and take a look at the form parts:

• Mode. You may use PayPal in 2 modes (live and test). If you want to test payments on your site before going live you need to select test mode and enter your sandbox email address in the last field of the form (Sandbox). If you are ready to go live, select live mode. In this mode sandbox email is not needed.
• Business. You need to specify your PayPal email address here.
• Process type. You may use one of three types here. They are Direct, PDT and IPN. The easiest way is to use Direct mode. In this mode you don't need to do any changes in your PayPal account. The second one is PDT. If you want to use it, you need to enable PDT in your PayPal account and get a token there. Then you need to put it in the Identity token field. This method is more secure then the Direct one. The last one is IPN mode. In this mode you need to configure your PayPal account too. Use URL like the following http://www.your_domain.com/[path_to_una]/m/payment/finalize_checkout/paypal/[number] as notification URL in your PayPal. You may find necessary URL in Data return URL field. In this mode PayPal will notify UNA script about processed payment automatically when the payment was completed. It's useful when you have a lot of payments with eCheck or pending payments which are not processed immediately.
• Check Active checkbox and save the form. Now you should be able to accept payments via PayPal.

Note. Current PayPal integration allows to accept Single Time payments only.

Configuring Stripe:

Open the Stripe slider and take a look at the form parts:

• Mode. You may use Stripe in 2 modes (live and test). If you want to test payments on your site before going live you need to select test mode and enter your Public and Secret test keys in Public Key (test) and Secret Key (test) fields accordingly. If you are ready to go live, select live mode and fill in Public Key (live) and Secret Key (live) fields. In this mode test keys are not needed.
• Check Enable amount checking checkbox if you don't plan to change payments, subscriptions or use coupons, discounts directly via your Stripe account.
• Check Enable SSL checkbox if your site has SSL certificate. It's recommended to use SSL to reduce the number of rejected payments.
• Check Active checkbox and save the form. Now you should be able to accept payments via Stripe.

Note. Stripe integration allows to accept both Single Time and Subscription payments.

Configuring Stripe Connect:

Stripe Connect is needed to connect platform (site author's) Stripe account with Stripe accounts of site members. It's needed if site author wants to organize Market (using, for example, the default UNA Market app) on his site and take comissions from Market sellers. In this case the system should be configured from both ends: as site author, as common Marker seller.

• As site author.

1. First of all you need to install Payments and Stripe Connect apps via Studio -> Apps Market.
2. When the App was installed you need to find Stripe Connect App in the Studio home page and open it. Now you need to configure necessary settings:

• Mode. You may use Stripe Connect in 2 modes (live and test). If you want to test payments on your site before going live you need to select test mode and enter your Client ID, Public and Secret test keys in Client ID (test), Public Key (test) and Secret Key (test) fields accordingly. If you are ready to go live, select live mode and fill in Client ID (live), Public Key (live) and Secret Key (live) fields. In this mode test keys are not needed. Client ID can be found in your Stripe account -> Account settings popup -> Connect tab. Development client ID is needed for test mode, Production is for live one. Also you may see Redirect URLs fields just after Client ID. You need to enter Redirect URL which can be found in Studio -> Stripe Connect -> Settings page -> Redirect URL field. Public and Secret keys for live and test modes can be found in Stripe account -> Account settings popup -> API Keys tab.
• Scope. This setting should be set to Read Write.
• One-time payments processing mode and Subscription payments processing mode. There are two ways of payments processing: Process the payment directly on the connected account (Direct) or Process the payment on the platform’s account, and then transfer necessary funds to dependent account (Platform). With the first approach, the connected account is responsible for the fees, refunds, and chargebacks. The payment itself will appear as a charge in the connected account. The second approach provides much more customizability but makes the platform account responsible for the fees, refunds, and chargebacks. The payment appears as a charge in the platform account, along with a transfer from the platform account to the connected account. Currently Platform processing type is available for One-time payments only.
• One-time fee. It can have a fixed value in cents (use just a number) or a percentage (use a number with % sign).
• Subscription fee. It can have a percentage only (use a number with % sign).

• As Market seller.

1. First of all you need to go to Dashboard page and find 'Stripe Connect' block.
2. Click with 'Connect' button. It will requre you to login into your Stripe account and confirm the connection.
3. Return to Dashboard page -> 'Stripe Connect' block. You should see Public and Secret keys generated for you during connection creation. Now you need to enter them in Stripe settings (Account popup -> Orders -> Settings). You may read more about it in 'Configuring Stripe' section above. Note. If Stripe Connect is set to test mode then test Public and Secret keys will be generated during the connection. Before going life you need to close all test connections, which can be done via Studio -> Stripe Connect -> Accounts page.