Configuring Stripe Direct and Stripe Connect
You can configure Stripe Direct with a Stripe processing path and offer EMV and contactless payments as part of your marketplace or platform with Stripe Connect.
Configuring Stripe Direct
  1. Go to the Test Gateway Manager or to the Live Gateway Manager to create a new merchant with a Stripe Processing Path.
  2. Enter your Stripe Test secret key or Stripe secret key, accordingly.
  3. Create a
    merchantSecretKey
    for the new merchant.
Configuring Stripe Connect
Full support for Stripe Connect enables you to offer EMV and contactless payments as part of your marketplace or platform.
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 that workflow, you will receive the
    stripe_user_id
    , which must be provided as the
    Stripe Account ID.
  • For Managed Accounts, you will receive the Stripe Account ID after creating the account.
During development and for pilots, you can perform all required merchant configuration 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.
Configuring a Merchant to Create Charges 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 drop-down menu.
Configuring a Merchant 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 drop-down menu.
If you want to refund a charge that has been created on your Stripe Platform Account, use the Stripe API to directly refund the charge and make sure to set the
reverse_transfer
parameter to
true
.
To learn how to get the required Stripe Charge ID, see "Accessing the Stripe Charge ID" in this procedure.
Configuring
Stripe Direct and Stripe Connect
You can configure Stripe Direct, Stripe Connect, and connected accounts.
Configuring Stripe Direct
  1. To create a new merchant with a Stripe Processing Path, head to the Test Gateway Manager or the Live Gateway Manager.
  2. Make sure to enter your Stripe Test secret key or your Stripe secret key accordingly.
  3. Create a
    merchantSecretKey
    for the new merchant.
Configuring 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.
Configuring a Merchant to Create Charges 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 drop-down menu.
Configuring a Merchant 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 drop-down menu.
If you want to refund a charge that has been created on your Stripe Platform Account, use the Stripe API to directly 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.