Need Help? Let's Find the
Answer Together!

Sorry, we didn't find any relevant articles for you.

Send us your queries using the form below and we will get back to you with a solution.

Batch Processor

Topics on Batch Processor

How do I start or stop the Batch Processor

1.1. Navigate to the Merchant Facility Navigate to the Payments2Us App Click on t ...

1.1. Navigate to the Merchant Facility

Navigate to the Payments2Us App

  1. Click on the 9 dots in top Left
  2. Search "Payments2Us"
  3. Click on "Payments2US"

In Salesforce Classic - The Merchant Facility Tab can be found under the "+" at the end of the tabs.

Navigate to list of Merchant Facilities

  1. Click on the Merchant Facility Tab
  2. Click on the down arrow
  3. Select "All Merchant Facilities

Select (3) Active (1) and Primary (2) Merchant Facility (If only one or not primary, then select the first one shown)

1.2. Start/Stop the Batch Processor

The Batch Payments Processors section is about 1/4 of the way down the screen.

  • Press the Button "START" to Start. Note, after starting, the label changes to STOP.
  • If already started, press the "STOP" button to stop. Note, after stopping, the label changes to START.

How do I check for and cancel duplicate Batch Processors running?

1.1. Navigate to Setup > Scheduled Jobs Click on the setup cog (top right) Sea ...

1.1. Navigate to Setup > Scheduled Jobs

  • Click on the setup cog (top right)
  • Search "Scheduled Jobs" and click into Scheduled Jobs

1.2. Look for duplicate job names beginning with "batchPaymentsProcessor" and delete

  1. Sort current jobs by Job Name
  2. Check to see if there are multiple scheduled jobs with the name starting with "batchPaymentsProcessor".
  3. ONLY IF THERE IS MULTIPLE. Press Del for each processor. Make sure you do the next step of restarting the batch processor.

1.3. Restart Batch Processors

See procedure: How do I start or stop the Batch Processor and START the Batch Payments Processor.

How to I remove Phantom Batch Processors?

1.1. Phantom Batch Processor Introduction On rare occasions, a Batch Processor ma ...

1.1. Phantom Batch Processor Introduction

On rare occasions, a Batch Processor may get stuck in a processing status of Queued. This seems to occur when Salesforce has done upgrades.

Symptoms of this happening are when Payment Txn Status's get stuck in Receipting Complete Status and the Batch Processor status on the Merchant Facility is showing as running.

From version 7.7 onwards, an Error Log is created indicating this condition exists.

 

1.2. Check for duplicates

Before continuing with this procedure, first check to see if multiple processors are currently scheduled. If they are, you can simply stop those and all should be ok. If you are still observing issues or getting error reports after that, then continue with this procedure.

See procedure: How do I check for and cancel duplicate Batch Processors running? 

1.3. Stop the Batch Processors

See procedure How do I start or stop the Batch Processor on how to STOP the Processors

1.4. Query Phantom Batch Processor Jobs from Developer Console

1.4.1. Open the Developer Console

  • Top right click on the settings cog
  • Followed by Developer Console

1.4.2. Run query on Batch Processors

  1. Click on the query tab.
  2. Paste “SELECT Id,Status,JobType,ApexClass.Name,CreatedDate,LastProcessed,JobItemsProcessed,NumberOfErrors FROM AsyncApexJob WHERE (JobType IN ('BatchApex','ScheduledApex') AND status IN ('Holding', 'Queued', 'Processing', 'Preparing') AND ApexClass.Name IN ('batchProcessor') AND ApexClass.NameSpacePrefix = 'AAkPay')” into the query
  3. Then press Execute
  4. Double click into the Id Cell. Copy the ID.
  5. NOTE, you will need to repeat Step Execute code to Abort Phantom Job for each row. NOTE Press the Execute (step 3) button each time Batch Processor Id's might change in the time it takes you to do the other steps.
SELECT Id,Status,JobType,ApexClass.Name,CreatedDate,LastProcessed,JobItemsProcessed,NumberOfErrors FROM AsyncApexJob WHERE (JobType IN ('BatchApex','ScheduledApex') AND status IN ('Holding', 'Queued', 'Processing', 'Preparing') AND ApexClass.Name IN ('batchProcessor') AND ApexClass.NameSpacePrefix = 'AAkPay')

1.5. Developer Workbench

1.5.1. Login to Developer Workbench

1.5.2. Select API Version 31

Click on the top link with the user + company + version No.

Select Version 31

1.5.3. Run Apex Code to Abort Phantom Jobs

  • Select "Apex Execute" from the Utilities Menu
  • Press Next button

1.5.3.1. Execute code to Abort Phantom Job

  1. Copy “system.abortjob('7074Q00007LyJwe'); “
  2. Change “7074Q00007LyJwe” to the id that was copied from Step 3 above.
  3. Press Execute
  4. Repeat for each Id in Step Run query on Batch Processors. NOTE, you should press the EXECUTE button (as in the Run query on Batch Processors step) again as the Id's might have changed in the time you've taken to do these updates. Continue to repeat until there are no Id's left from the query.
system.abortjob('7074Q00007LyJwe');

1.6. Restart Batch Processors

See procedure How do I start or stop the Batch Processor on how to START the Processors.

I keep getting the following error: Please investigate this error.Program/Area: batchProcessor.statusUpdateSubject: Database.update(paymentTxnList)Description: The new owner must have read permission.

The owner on the Payment Txn has the correct access, what is causing this? Check ...

The owner on the Payment Txn has the correct access, what is causing this?

  1. Check the Payment Form used by the Payment Txn. see which user is in the Donor Care field
  2. On the user, give them the Payments2Us Admin permission set. See Step No. 5 here on how to assign permission sets.

We've tried the above, but are still getting and error "Error Log Report - submit batch failed (nn) times."

1. Check for ApexToken Batch Jobs ApexToken jobs are internal jobs used by the Sa ...

1. Check for ApexToken Batch Jobs

ApexToken jobs are internal jobs used by the Salesforce Platform to manage flex queues. See: https://help.salesforce.com/articleView?id=000338931&type=1&mode=1 for more information.

On occasions, these can become stuck and cause other jobs (including Payments2Us ones) to also remain on hold.

 

The below sections provide you with all the information you need. Should Salesforce support come back with further questions, or if you need more information, then you will also need to have Payments2Us Premium support.

This issue is a Salesforce platform one and should NOT require you to have Salesforce developer support. If Salesforce support insists on this, we suggest you contact your Account Manager to escalate, or point support to the following bulletin board articles where this was previously resolved.

Read through the information below in this article before contacting Salesforce support as it with locate the information you need and if this is actually the issue that is causing your problems.

 

2. Open the Developer Console and check for stuck ApexToken Jobs

2.1. Open the Developer Console

  • Top right click on the settings cog
  • Followed by Developer Console

2.2. Run query on ApexToken Jobs

  1. Click on the query tab.
  2. Paste “SELECT Id, JobType, ApexClass.Name,CreatedDate, Status FROM AsyncApexJob WHERE JobType = 'ApexToken'” into the query
  3. Then press Execute

You'll need a screenshot similar to the below when logging a Salesforce support request.

 

SELECT Id, JobType, ApexClass.Name,CreatedDate, Status FROM AsyncApexJob WHERE JobType = 'ApexToken'

2.3. Determine if you have an ApexToken issue

In the screenshot in step "Run query on ApexToken Jobs" above, for item (4), you can see that there are two jobs that are at a "Queued" status since 2016. If there is ONE or more jobs that have a queued date this is old (more than a day or so), then this indicates you have this particular issue. If that is the case, then continue with the next steps

3. Locate jobs being held up

This step will be required when submitting the case to Salesforce support. They are likely to asked you for an example of a job being held up.

From setup (Cog - top right hand corner). Search for "Apex Job" and click into the menu option.

3.2. Add a filter to show queued or running jobs

Click the Create New View link that is next to the View picklist filter options

  • Give the filter a name, e.g. "All Running Jobs"
  • Add a filter based on the Status equals Queued,Processing,Preparing,Holding
  • Press the SAVE As button

3.3. Locate Jobs that are held

If you see jobs that have a "Submitted Date/Time" that was quite a while ago. In particular if you see "batchProcessor" (Apex Class) and the Submitted Date/time was more than an hour ago, then that is an example of a job affected by the ApexToken held job issue. You will need info when contacting Salesforce support.

You'll need a screenshot similar to the below when logging a Salesforce support request.

 

4. Logging a support case with Salesforce

The ONLY way this issue can be fixed is through Salesforce support/developer support.

Log a case along the following lines.

Subject: "Apex Batch Jobs hanging caused by ApexToken jobs stuck in Hold status"

Description:

Dear support,

We have a platform issue whereby ApexJobs are being held up by stuck/held ApexToken Jobs.

We understand from bulletin boards that this is going to require this case to be escalated. This is as noted at:

We have observed the stuck Apex Jobs (Copy/attached screenshots from step "Run query on ApexToken Jobs")

This is causing our Apex Jobs to become stuck (copy/attach screenshots from step "Locate Jobs that are held")

The above is a known Apex Flex Queue issue and is NOT A DEVELOPER SUPPORT ISSUE. We understand the Developer Support Team from Salesforce may need to get involved in fixing the Salesforce platform issue though.

Why does the Batch Processor skip processing some Payment Txns

The result of the Batch Processor running is the Matching Process is performed to ...

The result of the Batch Processor running is the Matching Process is performed to link to existing Accounts/Contacts or to create new ones.To avoid possible issues, the processor checks to see if the group of transactions it is trying to process might have possible duplicate Contacts. If it does, it skips processing these and will then pick those for processing in the next run (approx 10 minutes time).

The duplicates within the group of Payment Txns include:

  • Email
  • Membership No
  • Fundraiser Id
  • Reference
  • Mobile Phone
  • Contact Id
  • Account Subscription or Contact level Subscription
  • First/Last Name

In the Apex Job logs, I see that the batch processor scheduler is constantly being aborted

In the Apex Jobs, the Batch Processor is constantly being aborted/submitted. The ...

In the Apex Jobs, the Batch Processor is constantly being aborted/submitted. The reasons for this are:

  • Salesforce ONLY provides a method of running a batch processor daily. Payments2Us need this to run more frequently.
  • Payments2Us schedule for 10 minutes time. The Batch Processor starts in 10 minutes.
  • Then instead of waiting a whole day, Payments2Us cancel the job and then reschedules to run again in the next 10 minutes time.
  • The above means Payments2Us can effectively run the batch processor every 10 minutes, vs. daily.

Sometimes, what can happen is Salesforce delays the batch process due to maintenance, server loads etc. and the sequence of this can go out and then the possibility of 2 run. When this happens, you need to STOP, then re-START the Batch Processor. 

What is the Contact Update Processor (contactUpdateProcessor)?

When a new Merchant Facility is created or the "Print Email Receipt" is changed o ...

When a new Merchant Facility is created or the "Print Email Receipt" is changed on the Primary and Active Merchant Facility, then a background processor called "contactUpdateProcessor" runs.

This process copies the value in the field "Print Email Receipt" on the Merchant Facility to all Contacts, field - "Print Email Receipt".

This is required as some Workflows/Flows will send Receipts/Reminders/Statements to the Contact. If the Contact does NOT have an email, then the Print Email Receipt will have an internal users email address. The internal person receiving the email will then print of the document and mail out.

NOTE:

The processor updates contact records. This may update Contacts have have invalid data or validation rules. This means the updates are not successful and the Payments2Us Error Log entry is created with the error.If you were to do an edit/save on the Contact record, you would very likely receive the same error message - I.e. This is a data issue in your system and not Payments2Us related.

Why are Opportunities not being created?

Please check the following: "Error Log - Payments2us". There might be an error in ...

Please check the following:

  1. "Error Log - Payments2us". There might be an error in here that describes an issues. This is likely to be a restricted Picklist, Validation Rule, Flow/Process Builder issue (NOTE: Issues caused by these are outside the scope of Payments2Us Standard support)
  2. The Batch Processor might need to be stopped/started. 
  3. Receipting might be set to Manual or Similar. See Checkout FAQ for Payment Txns being stuck.
  4. The user that started the Batch Process might not have a Payments2Us Permission Set assigned.
  5. Perhaps the Opportunity was created and then later deleted. Please check your Recycle Bin for the Opportunity.

How is the Payment Txn Record Owner Assigned?

The Payment Txn Record Owner is initially assigned: For Transactions that are cre ...

The Payment Txn Record Owner is initially assigned:

  • For Transactions that are created online (Public Website), then the person that Authorised Payments2Us App will be the record owner.
  • For Transactions that are created by logged in Salesforce Users, then the owner will be the logged in User

When the Batch Processor runs and changes the Status from Receipting Complete to Matching Start/Complete, a check is performed to see if there related Payment Form, field "Donor Care" has an Active User entered. If there is, then the owner is changed to that User.