What does this section cover?
What are Stripe Payment Gateway Runs?
Payment Gateway Runs are used to log the execution of the payment runs. A new payment gateway processing run is created each time a payment processing run definition is applied.
Payment Gateway runs can be performed only within an effective payment gateway run definition.
A new payment gateway run is created each time a recurring Stripe Payment Gateway Run Definition is submitted. Whenever a run has been submitted, the following are executed:
- The bills that should automatically be paid are identified, based on the following criteria:
- The accounts receivable includes the Stripe accounts receivable payment preference and is also set to be used for recurring payments
- If segment criteria exists then
- Accounts receivable are filtered based on the specified segments
- The bill is included in the latest normal billing run or in one of the specified normal billing runs
- The bills due date is equal or before the date of execution (i.e the bills are due)
- The bills are unsettled
- If the run is executed only for failed payment requests then
- A rejected payment gateway request referring to that bill exists
- A payment gateway request is created, using:
- The stripe accounts receivable payment preference's default card
- The payment type, payment method, payment category and payment notes specified on the payment gateway processing run definition
- The requests are submitting new charges to Stripe system
- The related successful payments are created in CRM.COM.
In order to modify the scheduling information of a submitted Payment Gateway Run you can Edit the definition.
Creating, Editing & Deleting Validations & Restrictions
Action | Validations |
---|---|
General | N/A |
Create |
|
Edit | N/A |
Delete |
|
Save |
|
Stripe Payment Gateway Run attributes
Name | Description |
---|---|
Unified code | An auto generated code which is used to group the various instances of each Payment Gateway Run Definition |
Name* | The name of the definition |
Alternative code* | The alternative code of the definition |
Description | A description of the definition that can be used for the description element sent to the order |
Life cycle state | The life cycle state of the definition. The supported values are effective and not effective |
State | The state of the definition which can be active or inactive. Only one active definition can exist at any point |
Version | An auto generated number which is used to specify the version of each Payment Gateway Run Definition. New Payment Gateway Run Definition versions are created each time they are edited, if they are already been used by any payment gateway runs |
Payment Gateway | The payment gateway that it will be used to execute the run, should default to the active Stripe Payment Gateway Provider |
Payment Settings | |
Payment Type* | The payment type that will be used by the process in order to create the payments that will be submitted to Stripe Payment Gateway |
Payment Method* | The payment method that will be used by the process in order to create the payments that will be submitted to Stripe Payment Gateway. Only payment methods included in Stripe Payment Gateway Provided can be selected. |
Payment Category | The payment category that will be used by the process in order to create the payments that will be submitted to Stripe Payment Gateway. |
Payment Notes | Notes that will be added on the payment that will be created |
Criteria | |
Accounts Receivable Criteria: | It defines the criteria that will be used to retrieve the unsettled bills that will automatically be paid |
Billing Run Filter Method* | It determines the method that will be used to filter the bills. The supported options are the following:
|
Billing Run Selection | A set of normal billing runs that will be considered in order to retrieve theunsettled bills that will automatically be paid. This option is applicable and mandatory only if the "Bills included in specific billing runs" option is selected as a Billing Run Filter Method Mandatory Conditions: Only if the Bills included in specific billing runs option is selected |
Process only failed payment requests | If enabled then the process will retrieve only bills which were already processed and failed to be submitted to Stripe |
Segment Criteria | Determines the criteria that are used to identify the accounts that need to be paid. At least one segment should be specified, in one of the two options |
Included in Segment | A list of segments which are used to filter the payment gateway accounts that will be sent for payment. The criteria consist of the following:
|
Not Included in Segment | A list of segments which are used to excluded the payment gateway accounts that will be sent for payment. The criteria consist of the following:
|
Scheduling Settings | |
Scheduling Settings* | Determines when the definition should be applied in order to create the payment requests. Payment Gateway Run Definitions can be applied ad hoc or on a recurring basis. Scheduling settings hold the following information:
|
Configuring a Stripe Payment Gateway Run tailored to your company's needs
- Navigate to FINANCE > PAYMENT GATEWAY > STRIPE > PROCESS PAYMENT GATEWAY REQUESTS
- Either search for an existing one or from the Top Menu click on NEW
MAIN INFORMATION
Provide the required information
Name
Alternative Code
Description
View information regarding the following
Scheduled Date
Version
Life Cycle State
PAYMENT SETTINGS
Provide the required information
Payment Type
Payment Method
Payment Category: Search and select a payment category
Payment Notes
CRITERIA
ACCOUNTS RECEIVABLE CRITERIA
Provide the required information
Process Only Failed Payment Requests
Billing Run Filter Method
SEGMENT CRITERIA
Provide the required information
Included Segments: click on ADD and select a segment to be included during the stripe payment gateway run
Excluded Segments: click on ADD and select a segment to be excluded during the stripe payment gateway run
SCHEDULING SETTINGS
- Select from the available options according to what you would like to achieve
- RUN NOW: Will be executed once, now
- RUN ON SPECIFIC DATE/TIME: Will be executed once, at the date defined
- RUN REPEATEDLY: Will be executed, starting and ending at a defined date/time and will be repeated every X UOT where UOT can be from seconds to Years
- ADVANCED SCHEDULING: Will be executed, starting and ending at a defined date with powerful repetition options from daily to yearly
Run Now
Run On Specific Date / Time
- Start Process
- Click on the calendar select the date and time the run should start being executed.
- Once selected click on "DONE"
- Click on the calendar select the date and time the run should start being executed.
- Start Process
Run Repeatedly
- Start Process - On a Specific Date
- Click on the calendar select the date and time the run should start being executed.
- Once selected click on "DONE"
- OR Start process - After a period of time
- Provide how long after current date/time the process should begin
- Provide how long after current date/time the process should begin
- Repeat Process
- EVERY: Type a number (INTEGER)
- UOT: Select between
- Seconds
- Minutes
- Hours
- Days
- Weeks
- Months
- Years
- End Process
- Select between
- Never End
- On a specific date (define the date)
- After a period of time (define period of time)
- Select between
- Start Process - On a Specific Date
Advance Scheduling
- Start Process
- Click on the calendar select the date and time the run should start being executed.
- Once selected click on "DONE"
- Repeat Process
- Select between
- Daily : Define every how many days
- Weekly: Select specific days of the week
- Monthly:Define every how many months or on a specific day of the month
- Yearly: Define a specific date/month or a specific day of a month, such as the 1st Sunday of every January
- Select between
- End Process
- Select between
- Never End
- On a specific date (define the date)
- Select between
- Start Process
- Select from the available options according to what you would like to achieve
LOG INFORMATION
Unable to render {include} The included page could not be found.- From the Top Menu click on Save
Executing a Stripe Payment Gateway Run
- Navigate to the definition
- Search for the definition you would like to execute
- Click on the number of the definition to go to the data entry page
- Confirm that SCHEDULING SETTINGS are correctly configured
- From the Actions Menu click on ACTIONS > "SUBMIT"
- The job will be submitted to the scheduler and will become available under PROCESS RUNS
- Once completed the Life Cycle State will be changed from Draft to Completed
- If the Run fails then the Life Cycle State will be updated to Failed
- Check Process Successfully and Processed with Errors for a closer look of individual results
Modifying a Stripe Payment Gateway Run
When you edit a definition that already has completed or scheduled runs then the system will automatically update the Version of the definition, by increasing its number by 1. Essentially, the system will create a new definition and will carry over all the information and configuration, apart from the Version number.
Accessing a definition with multiple versions, you will always see the latest version, while you have the option to View configuration and Runs of Previous versions by using th "VIEW PREVIOUS VERSIONS" link found in the Main Information tab
- Click on the VIEW PREVIOUS VERSIONS link
- Search from the modal for the version you would like to see
- Select the version
- The system will now show the configuration and the process runs of the version you have selected.
- To go back to the current version click on the CURRENT VERSION link under Main Information
Deleting a Stripe Payment Gateway Run
Deleting a scheduled job of the specific Run
If you have scheduled (submitted) a Run by mistake or you want to change the definition before execution, you have the option to delete the current job that was sent to the scheduler, given that it has not been executed yet. i.e., Life Cycle State is still Draft.
In order to delete the job follow the steps below:
- Navigate to the definition, for which you have scheduled a job
- Click on the number of the definition to move in the data entry page
- Go to Process Runs tab
- Find the job and check the left box next to the Run
- Click on "DELETE"
- A modal will open with the job information
- Click on "DELETE"
- Click "OK" on the confirmation message
- Close the modal
The job will be removed from the Process Runs
Changing the Life Cycle State of a Stripe Payment Gateway Run definition
Definitions Life Cycle State can be changed between Effective and Not Effective by following the steps below
- Go to the data entry page of the definition'
- If the definition's Life Cycle State is set to "Effective"
- From the Actions Menu click ACTIONS > SET AS NOT EFFECTIVE
- If the definition's Life Cycle State is set to "Not Effective"
- From the Actions Menu click ACTIONS > SET AS EFFECTIVE
- From the Actions Menu click ACTIONS > SET AS EFFECTIVE
Reading Stripe Payment Gateway Run Logs
- Navigate to FINANCE > PAYMENT GATEWAY > STRIPE > PROCESS PAYMENT GATEWAY REQUESTS
- Search for an existing Payment Gateway Run that has been executed
Process Runs
- The following information is available regarding the Stripe Payment Gateway Run
- Number: The number of the run
- Version: The Run Definition's version
- Life Cycle State: The Life Cycle State of the Run
- Start Date: The date when the Run started
- End Date: The date when the Run ended
- Process Successfully: Drill down including the notifications created successfully.
Processed With Errors: Drill down including the entities that were not successfully processed thus no Stripe Payment Gateway Requests were created for the specified entities or they were rejected
Visit Configuring and Executing Stripe Payment Gateway Run to find out more information regarding created Stripe Payment Gateway Requests.
- The following information is available regarding the Stripe Payment Gateway Run
If you have access, you may navigate to Stripe, log in to your Merchant Account Dashboard to view more information regarding the Payment through Stripe.
Related Areas
-
Configuring Stripe Payment Gateway Provider — Learn to configure the Stripe Payment Gateway Provider
-
Registering a Credit Card with Stripe — Learn to register a Stripe Payment Gateway Card in CRM.COM
-
Using Stripe Payment Gateway Run Definition — Learn to configure the Business Definitions that dictate the overall behaviour of Process Payment Gateway Requests
-
Understanding Stripe Payment Gateway — Understand the usage of the Stripe Payment Gateway within CRM.COM
-
Managing Stripe Payment Gateway Requests — Learn to work with Stripe Payment Gateway Requests
Popular Labels
- accounts-receivable
- accounts-receivable-admin
- accounts-receivable-advanced
- accounts-receivable-advanced-r7
- accounts-receivable-basics
- activities
- activities-admin
- activities-admin-r7
- activities-basics
- activities-basics-r7
- additive-discounts-admin
- additive-discounts-advanced
- additive-discounts-basics
- billing-application
- billing-engine
- communication-centre
- communications-admin-r7
- communications-advanced-r7
- conax-web-services
- conax-web-services-advanced
- contact-information-admin
- contact-information-admin-r7
- crm-application
- crm-application-r7
- customer-events-basics-r7
- dashboards
- dashboards-advanced
- finance-application
- financial-transactions-admin
- financial-transactions-admin-r7
- financial-transactions-advanced
- financial-transactions-advanced-r7
- foundation-application
- foundation-application-r7
- global
- inventory-management-advanced
- inventory-management-basics
- inventory-management-basics-r7
- jobs
- jobs-admin
- jobs-admin-r7
- jobs-advanced
- jobs-basics
- jobs-basics-r7
- leads
- leads-admin
- leads-admin-r7
- leads-advanced
- network-management-basics
- network-management-basics-r7
- normal-billing-admin-r7
- normal-billing-r7
- normal-billing-run-admin
- normal-billing-run-basics
- notifications
- notifications-basics
- panaccess_advanced
- platform-basics
- prepaid-billing-basics
- prepaid-billing-r7
- products-admin-r7
- rated-billing-items-advanced
- rated-billing-items-basics
- reports-basics
- resource-scheduling
- resource-scheduling-advanced
- rewards-admin
- rewards-admin-r7
- rewards-advanced
- rewards-advanced-r7
- rewards-basics
- rewards-basics-r7
- security-management-advanced
- segmentation-basics
- service-requests
- service-requests-admin
- service-requests-admin-r7
- service-requests-advanced
- service-requests-advanced-r7
- stripe
- subscription-actions-r7
- subscriptions
- subscriptions-advanced
- subscriptions-advanced-r7
- subscriptions-basics
- subscriptions-basics-r7
- udrs-admin-r7
- usage-service-r7
- user-management
- user-management-basics
- vouchers-advanced
- vouchers-basics
- wallets
- wallets-advanced
- wallets-basics
- warranty-policies-advanced-r7
- workflows-admin-r7
- workflows-advanced-r7
- workflows-r7
- zapier-basics-r7