Stripe Integration
Samantha avatar
Written by Samantha
Updated over a week ago

Friendbuy allows you to use your existing Stripe account to reward customers for referring their friends to your product or service. We offer a Stripe Connect app directly in your Friendbuy account.

To implement the Friendbuy Stripe reward fulfillment model, simply:

  1. Connect your Friendbuy account to your Stripe account.

  2. Configure your SmartPixel to pass Stripe customer IDs.

  3. Configure the reward settings for your campaign(s) to issue Stripe Credit.

Detailed Procedure

Connect your Friendbuy account to Stripe

  1. Login to your Friendbuy account.

  2. Navigate to the Integrations page.

  3. Click on the Connect button under the "Stripe" section.

Configure your campaign(s) to issue Stripe credit

Navigate to Reward Configuration for your campaign and click “Edit.” In the resulting dialog, choose “Stripe Credit” under Reward Type and enter the amount of credit to be issued in the Reward Amount input field.

Note: If you have multiple campaigns for which you wish to issue Stripe credit, you will need to configure the Reward Criteria accordingly for each campaign individually.

Configure the Friendbuy SmartPixel with your Stripe Customer ID

In order for Friendbuy to issue credit to the correct Stripe account, Friendbuy must know the Stripe Customer ID.

Edit your Friendbuy SmartPixel to include the Stripe Customer ID parameter. See below for an example:

window['friendbuy'].push(['track', 'customer',
    {
        id: "7896751",
        stripe_customer_id: "cus_83ucdilfwd",
        email: "email@example.org",
        first_name: "John",
        last_name: "Smith"
    }
]);

Note: If you have multiple installations of the SmartPixel, each one should be updated with this change.

For more information about Friendbuy’s SmartPixel and how to configure its parameters, you can read our SmartPixel Overview documentation.

FAQ

  • Is Friendbuy's Stripe Integration for me?

  • In what form does Friendbuy issue Stripe credit?

  • When connecting Stripe to my Friendbuy account, why does Stripe ask, "Friendbuy would like you to start accepting payments with Stripe"? Isn't Friendbuy just going to issue account credit?

Is Friendbuy's Stripe Integration for me?

If you use Stripe to charge your customers for a recurring service (such as a subscription) and wish to offer a discount off of their next invoice, then this integration will work for you.

At this time, Friendbuy does not support issuing Stripe coupons for one-time purchases.

In what form does Friendbuy issue Stripe credit?

Friendbuy issues credit against the customer's account balance. The account balance applies only to recurring charges (such as invoices) against the customer's account.

According to Stripe's Customer API documentation, the account balance is:

Current balance, if any, being stored on the customer’s account. If negative, the customer has credit to apply to the next invoice. If positive, the customer has an amount owed that will be added to the next invoice. The balance does not refer to any unpaid invoices; it solely takes into account amounts that have yet to be successfully applied to any invoice. This balance is only taken into account for recurring billing purposes (i.e., subscriptions, invoices, invoice items).

When connecting Stripe to my Friendbuy account, why does Stripe ask, “Friendbuy would like you to start accepting payments with Stripe”? Isn’t Friendbuy just going to issue account credit?

The only interaction Friendbuy has with your Stripe account is to issue account credit to a single customer at a time, in the amount of your choosing using the criteria you have specified.

That being said, Stripe only has two permission levels for Connect applications: “read” or “read/write”. “Read” permission only allows a Connect application to read data from an account - no modifications are allowed. “Read/write” allows a Connect application to modify data for an account. While Friendbuy only modifies one property, it is still necessary to grant “read/write” privileges.

If and when Stripe implements more fine-grained permissions for Connect applications, Friendbuy will be able to request more specific permissions.

Did this answer your question?