Configuring Stripe Payment Processor

       Add Stripe as your payment processor

Assign Stripe as a payment system for a particular currency

Specify email for a customer


Stripe is one of the most widely used payment processing systems in the world and supports over 135 currencies. It provides a simple and transparent fee structure and supports payments using both credit card information and tokens.

Stripe payment system is different from other payment processors available in PortaBilling® as it is integrated with the help of PortaOne® iPaaS. This means that PortaBilling® doesn’t send the requests directly to Stripe. PortaBilling® sends the request to PortaOne® iPaaS, and PortaOne® iPaaS “talks” to Stripe via API.

Pre-requisites for using Stripe as a payment system in PortaBilling®:

·       Active PortaOne® iPaaS subscription

·       Stripe iPaaS integration activated by PortaOne® engineers

·       Existing active Stripe Merchant account (corresponding API key)

Configure Stripe as your payment processor

1.      On the navigation menu, select Financial, then select E-payments, and open the Payment systems panel.


Navigation menu


2.      On the Create payment system panel, fill in the following information:

·       Name – type in an arbitrary name you assign to the payment system.

·       Payment processor – select Stripe.


Select Stripe as a payment processor


·       Login – type in any info as it is ignored by iPaaS (however, this field is obligatory and the input must be longer than 4 characters).

·       Password – input the Stripe API key.

Note: The Stripe API uses API keys to authenticate requests. Every account is provided with separate keys for testing (sk_test_) and for running live transactions (sk_live_).

There are also two types of API keys: publishable and secret. 

Publishable API keys are meant solely to identify accounts with Stripe; they aren’t secret and are used for the test mode. 

Secret API keys can perform any API request to Stripe without restriction and are used for live transactions.

·       Test mode – disable this option to use Stripe for live transactions (only enable for test mode if you intend to use it).


3.      Click Save.


Fill in the Login and the Password fields


4.      On the Payment system panel, click on the Payment methods link.

5.      On the Payment methods page, select all the check boxes for the payment methods that you intend to enable with Stripe (VISA, MasterCard, American Express, or Discover).


Select payment methods


6.      On the Data protection page, select one of the following options for stored card information handling:

·       Token only – during the first payment, all the credit card information is collected and sent to Stripe once, and a payment token is created. This token is used for all further transactions (no need to enter the card information again).

·       Full card info except the CVV – during every payment, all the credit card information is sent to Stripe.

Select the option for stored card information handling

7.      Click Save.

Assign Stripe as a payment system for a particular currency

1.      On the navigation menu on the left, select Financial and then Currency management.

2.      On the Currencies panel, select the desired currency (for example, USD or CHF).

3.      Click the Edit   icon.

4.      Click the Add  icon next to Payment and remittance systems.

5.      Specify the following information:

·       Type of system – select Payment system.

·       Payment system – select Stripe.

·       Minimum payment – set “0.5 USD” (or equivalent in other currency you use, e.g., 0.46 CHF).

Note: Transaction limitations apply for Stripe. 0.5 USD is the minimum allowed transaction size. If the end user attempts to make a payment lower than 0.5 USD (or equivalent in other supported currency), Stripe will return an error in PortaBilling® and a notification about an unsuccessful transaction (for example, “Your payment must be no less than 0.5 USD”) will also be displayed to the end user on self-care portal.

6.      Click Add.


Specify the minimum allowed transaction size


7.      Click Save.


Now that Stripe is configured as a payment system, all the standard payment processor functions are available for it (Add/Save/Delete the payment method (card), etc.). The only transaction type that’s unavailable is Void because in Stripe, all the authorized transactions expire in 7 days. The transactions cannot be voided (Stripe will return an error upon attempt to void a transaction).

Specify email for a customer

In order to use token-based payments in Stripe, it’s necessary to set a valid email for a customer. An email is necessary for the first transaction – for the token to be generated. Without it, Stripe returns an error.

To specify an email for a customer, e.g., John Doe:

1.      Open John Doe’s record.

2.      On the Personal page, go to General info.

3.      Input a valid email belonging to John Doe into the Email field.


Specify email for a customer


4.      Click Save.