Setup

Stripe Direct

Head to the Test Gateway Manager or to the Live Gateway Manager to create a new Merchant with a Stripe Processing Path and make sure to enter your Stripe Test Secret Key or your Stripe Secret Key accordingly. Also create a merchantSecretKey for the new Merchant.

 

Stripe Connect

If you want to offer EMV & contactless payments as part of your marketplace or platform, Payworks makes this easy for you as well with full support for Stripe Connect.

Working with Connected Accounts

In general, you need to provide the Payworks platform with the Stripe Account ID (starting with acct_*) of the connected account that should receive the payment.

For Standalone Accounts, you first need to make sure, that the Standalone Account is successfully connected to your own Stripe Platform Account. The Stripe documentation explains how to implement the required OAuth workflow for this. In the last step of this workflow, you will receive the stripe_user_id, which must be provided as the Stripe Account ID.

For Managed Accounts, you will receive Stripe Account ID after creating the account.

During development and for pilots, you can perform all required Merchant Setup through the Gateway Manager as documented below. Later on, you can use the Payworks API to automatically set up the Merchants on the Payworks Platform.

Merchant Setup to Create Charges Directly on the Connected Account

In the Gateway Manager, create a new Merchant with a Stripe Processing Path and make sure to specify the Secret Key of your own Stripe Platform Account as the Stripe Secret Key.

To create the charge directly on the connected account, specify the Stripe Account ID of the connected account and select "Create Charges directly on the connected account" from the dropbox.

Merchant Setup to Create Charges on the Platform Account

In the Gateway Manager, create a new Merchant with a Stripe Processing Path and make sure to specify the Secret Key of your own Stripe Platform Account as the Stripe Secret Key.

To create the charge on your Stripe Platform account, specify the Stripe Account ID of the connected account and select "Create Charges on the platform account" from the dropbox.

If you want to refund a charge that has been created on your Stripe Platform Account, we strongly recommend that you use the Stripe API directly to refund the charge and make sure to set the reverse_transfer parameter to true.

See Accessing the Stripe Charge ID above to learn how to get the required Stripe Charge ID.

Stripe Direct

Head to the Test Gateway Manager or to the Live Gateway Manager to create a new Merchant with a Stripe Processing Path and make sure to enter your Stripe Test Secret Key or your Stripe Secret Key accordingly. Also create a merchantSecretKey for the new Merchant.

 

Stripe Connect

If you want to offer EMV & contactless payments as part of your marketplace or platform, Payworks makes this easy for you as well with full support for Stripe Connect.

Working with Connected Accounts

In general, you need to provide the Payworks platform with the Stripe Account ID (starting with acct_*) of the connected account that should receive the payment.

For Standalone Accounts, you first need to make sure, that the Standalone Account is successfully connected to your own Stripe Platform Account. The Stripe documentation explains how to implement the required OAuth workflow for this. In the last step of this workflow, you will receive the stripe_user_id, which must be provided as the Stripe Account ID.

For Managed Accounts, you will receive Stripe Account ID after creating the account.

During development and for pilots, you can perform all required Merchant Setup through the Gateway Manager as documented below. Later on, you can use the Payworks API to automatically set up the Merchants on the Payworks Platform.

Merchant Setup to Create Charges Directly on the Connected Account

In the Gateway Manager, create a new Merchant with a Stripe Processing Path and make sure to specify the Secret Key of your own Stripe Platform Account as the Stripe Secret Key.

To create the charge directly on the connected account, specify the Stripe Account ID of the connected account and select "Create Charges directly on the connected account" from the dropbox.

Merchant Setup to Create Charges on the Platform Account

In the Gateway Manager, create a new Merchant with a Stripe Processing Path and make sure to specify the Secret Key of your own Stripe Platform Account as the Stripe Secret Key.

To create the charge on your Stripe Platform account, specify the Stripe Account ID of the connected account and select "Create Charges on the platform account" from the dropbox.

If you want to refund a charge that has been created on your Stripe Platform Account, we strongly recommend that you use the Stripe API directly to refund the charge and make sure to set the reverse_transfer parameter to true.

See Accessing the Stripe Charge ID above to learn how to get the required Stripe Charge ID.

Can we help you?

If you cannot find your answer, contact us and we'll get in touch with you soon.

© Copyright 2017 Payworks GmbH. Legal.