Stripe Setup - Configure your Payment Platform

Clearing G/L Account

Select the G/L account to which you want to record unpaid Stripe activity. As activity is performed in Stripe, an outstanding balance of unpaid payments is accumulated. At some point, Stripe is instructed to perform a payout, at which point these unpaid amounts are moved from the Stripe balance to a specified balancing account. The frequency with which Stripe performs payouts (as soon as funds are available, weekly, monthly, or on demand) is configured within Stripe.

Fee G/L Account No.

Select the G/L account number to which you want to record Stripe transaction fees

Dimension Set Fee Behavior

Select the method that CPM will assign Dimensions to entries it posts to the specified fee G/L account as well as related balancing entries. 
• Default: Dimensions will be assigned according to any default Dimensions that have been defined for the fee G/L account.
• Inherit: Dimensions will be inherited from the related transaction in Business Central. For example, a payment posted from a sales order would have all of that sales order’s Dimensions assigned to the fee G/L account entry.

Account Type

Indicate whether the balancing account to which Stripe payouts are processed will be a Business Central G/L account or bank account record. Typically, a bank account record is used, but you should select whichever option reflects your desired processes

Account No.

Select the Business Central G/L account or bank account (depending on the selected payout balancing account type) to which processed payouts will be recorded. CPM automatically detects payout transactions in Stripe and will post the corresponding activity to your specific balancing account

A valid bank or G/L account

Default Posting Account Type

Indicate the record type of the Business Central account to which CPM can record payment platform activity that was created by other systems on Stripe. When you are working in the Transaction Worksheet, the default posting account can be assigned to outstanding transactions so that all activity can be quickly posted. The default posting account can be a G/L account, customer, vendor, bank account, fixed asset, IC partner, or employee record. Typically, a G/L account or customer record is used, but you should select whichever option reflects your desired processes. 

G/L Account ; Customer

Default Posting Account No.

Select the account (depending on the selected default posting account type) that can be assigned by default to outstanding transactions in the Transaction Worksheet.

A revenue G/L account

Payment Request No. Series

Select the number series that you want to use to assign numbers to CPM payment request records. It is recommended that you create a new number series for CPM payment requests.

Default Payment Method

Select the payment method code that will be assigned to payment customer ledger entries that are created from payment platform activity. When payments are retrieved from Stripe, CPM will attempt to create new payment entries in the related customers’ ledgers. The payment platform’s default payment method will be assigned as the payment method for these customer ledger entries. You can create a new payment method for the payment platform or use an existing one, but regardless of this decision it is recommended that you assign a payment method with a blank balancing account number. 

Payment Request Send Invoice

Select this option to indicate whether Stripe will automatically send an invoice to customers when a quick payment request is generated from within Business Central and communicated to Stripe. If this option is selected and a quick payment request is sent to Stripe, CPM will instruct Stripe to automatically send an invoice with the relevant payment request details to the related customer according to its configured collections functionality. If this option is disabled, quick payment requests will not include the instruction to send invoices to customers. This is useful if you want to send payment request invoices to your customers through a method other than Stripe.
Note that this option only applies to quick payment requests that are sent for the payment platform. When working with custom payment requests, you make the 
determination as to whether or not invoices are sent from Stripe on a request-by-request basis.

Re-Collect CVC on Saved Payment Method

Select this option to require the re-entry of a saved credit card’s CVC number. It is possible to assign a credit card as a customer payment method in Stripe. If this option is selected, Business Central will instruct user to re-enter a saved credit card’s CVC when attempting to process activity. While enabling this option adds an extra layer of security and can help to reduce fraudulent charges, it also creates an added step in the CPM process. For this reason, it is recommended that you leave this option disabled and then configure Stripe to require this step.

Authorization Validity

Enter the number of days for which a payment request for a credit card authorization will remain valid. When a payment request is created, CPM will apply this period to the record’s creation date to calculate an expiration date. If the authorized amount is not captured prior to this expiration date, the payment request expires and new one must be created. By default, Stripe maintains a seven-day authorization window; it is recommended that you assign this same value to the corresponding payment platform record in Business Central.

Capture Method

Select the method by which credit card payments for sales orders are processed. Because sales orders are open documents, CPM provides additional flexibility as to how credit card activity is handled. 

Blank: CPM will handle sales order payments according to the external payment platform’s default settings
 Immediate: CPM will automatically capture sales order payments.
 Delay: CPM will create a payment request authorizing the sales order payment. This authorization will remain open until it is captured at a later date or expires.

For more information on how this setting is used with sales order payment collection, please see here.

Authorization Behavior

If the payment platform is configured to delay the capture of sales order payments, you must select the method by which authorized payments are captured. 

Manual: authorized payments must be manually captured by a user.
Capture on Invoice: authorized payments are automatically captured when the sales order is invoiced.

It is not possible to define authorization behavior if the payment platform is configured to immediately capture sales order payments.
For more information on how this setting is used with sales order payment collection, please see here.

Reauthorization on Partial Capture

If the payment platform is configured to delay the capture of sales order payments, you must select the method by which an authorized payment is handled when a partial capture of the authorization amount is executed. 
Manual: if an authorized payment amount is partially captured, the user must manually record a new payment request record for the remaining amount of the authorization.
Auto: if an authorized payment amount is partially captured, CPM will automatically create a new payment request record for the remaining amount of the authorization.

It is not possible to define reauthorization behavior if the payment platform is configured to immediately capture sales order payments.
For more information on how this setting is used with sales order payment collection, 
please see here.

Refund Request No. Series

Select the number series that you want to use to assign numbers to refund requests. It is recommended that you create a new number series for CPM refund requests.

Build Invoice Codeunit

Enter the codeunit that will be used to create invoices in Business Central. CPM comes with out-of-the-box codeunit 70338652 that performs this activity, and typically this should be assigned. Users do, however, have the ability to create a custom codeunit and assign it here if the supplied codeunit does not properly reflect business processes. Again, more often than not the default codeunit will be sufficient.

Invoice No. Series

Select the number series that you want to use to assign numbers to invoices. It is recommended that you create a new number series for invoices to easily differentiate them from other sales invoices, but you can assign the same number series that is used for your standard Business Central sales invoices, if you wish

External Doc Prefix

Enter a value that will be added as a prefix to the external document number that is assigned to invoices. By default, the payment platform’s invoice ID number will be assigned as the corresponding invoice’s external document number. If an external document number prefix is defined, it will be entered as a prefix to this value. This prefix can be a maximum of four characters, but it is recommended that you use a three character value and then assign a hyphen or underscore as the fourth and final value to more clearly separate the prefix from the rest of the external document number. For example, an external document number prefix of SEP- would result in the creation of external document numbers SEP-11111111, SEP-22222222, etc.

Payment Method

Select the payment method that will be assigned to invoices. You can create a new payment method for invoices or use an existing one, but regardless of this decision it is recommended that you assign a payment method with a blank balancing account number.

Invoice Location

Select the location that will be assigned to invoices. This location will also be assigned to invoice lines and used as the fulfillment location for any lines that are created for inventory items. You can create a new location code for invoices or use an existing one.

Invoice Dimension 1

Select the dimension value that will be assigned to invoices. This field presents the dimension values that are defined for the dimension that is assigned as global/shortcut dimension 1 in Business Central.

Invoice Dimension 2

Select the dimension value that will be assigned to invoices. This field presents the dimension values that are defined for the dimension that is assigned as global/shortcut dimension 2 in Business Central

New Customer: Creation

Select the method by which new customers are created and/or assigned to invoices. When CPM retrieves an invoice from Stripe, it will attempt to match that invoice’s customer ID to an existing CPM customer link. If it is able to do so, it will create the invoice for the relevant customer. When it cannot find a match, it will adhere to the behavior specified in this field.  Depending on the option you select in this field, the setup fields that follow will dynamically change. The descriptions of each option below will also include information about these related fields.

Auto Create: CPM will automatically create a new Business Central customer based on the Business Central customer template that you specify in the Template field. You must also enter a number series in the No. Series field to assign a unique number to each customer. After the customer is created, the retrieved invoice will be assigned to it. CPM will also establish a CPM customer link for the new customer.
Payment Platform: a “platform-level” customer is assigned to the payment platform in the Customer No. field, and all retrieved invoices will be created for 
that customer.
Manual: you will manually set up new customers for retrieved invoices in Business Central and link them to corresponding Stripe customers. There are no additional setup fields for the manual option.

No. Series

The number series to use when creating a new customer from the platform

Template

The template to use when creating a new customer from the platform

Sales Tax Behavior

Select the method by which calculated sales tax should be handled on invoices. 
None: Business Central will ignore any sales tax calculations from Stripe. The Tax Liable field on the invoice will be enabled or disabled according to standard Business Central logic and sales tax will be calculated in the same manner as any other sales invoice.
Line: sales tax calculations from Stripe will be applied to invoices in Business Central. The Tax Liable field will be disabled (preventing Business Central from calculating sales tax) and a separate invoice line will be created for each tax amount for order-level charges (such as shipping and gift wrapping) that was calculated and collected in Stripe. It is recommended that you select this option so that recorded sales tax amounts are synchronized between your Business 
Central and Stripe platforms

Sales Tax Line Type

If you select the Line option in the Sales Tax Behavior field, indicate the type of account that will be assigned to invoice lines for sales tax. The sales tax line type can be a G/L account, item, resource, fixed asset, or item charge. Typically, a G/L account is used, but you should select whichever option reflects your desired processes

Sales Tax Line No.

Select the account (depending on the selected sales tax line type) that will be assigned to invoice lines for sales tax