Stripe Data Initialization
Before you can save payment methods or do payment transactions for an account, the account must be connected to the payment gateway.
There are two ways to link Salesforce accounts to a payment gateway.
Batch Customer Mapping - This is a function that downloads all customers from the payment gateway and then matches Salesforce accounts with the payment gateway customers by name.
This process does not create new customers in the payment gateway. It only finds payment gateway customers and matches them to Salesforce accounts by name.
Account’s Payment Gateway Customer Screen - From the account page, you can connect an account to a payment gateway. This function first tries to match the account to a payment gateway customer by name. If a payment gateway customer does not exist, it will create a new customer in the payment gateway and link the account to it.
Batch Customer Mapping
Go to Payment Console Settings.
Click on the dropdown menu button in the top-right corner, and click on the Connect Customers to Payment Gateway.
This function has 2 steps:
Download all customers from the payment gateway.
Match the downloaded customers with Salesforce accounts using the name.
From the Download Payment Gateway Customers section, choose a payment gateway and a connection.
Enter a batch number.
A batch will download 100 customers from the payment gateway (multiplying 100 by the number of batches will be the total number of customers you have in the payment gateway)
Increase or decrease the Batches as needed.
Click Download to start the download job. Wait for the download job to finish.
After the download job is finished, you can choose the payment gateway in the Match Customers section.
The system will show the number of unmatched customers. Click the Match button to start the matching job and wait for the job to complete.
After the job is completed, the system will update the Unmatched Record Count to show the remaining download customers who don’t have matching Salesforce accounts.
Click View Unmatched Payment Gateway Customers to see these records.
![](../__attachments/2733998139/image-20230921-155130.png?inst-v=7859a023-5511-40be-b967-a1e2fed73946)
![](../__attachments/2733998139/image-20230807-174804.png?inst-v=7859a023-5511-40be-b967-a1e2fed73946)
If the system had linked the payment gateway customers to the accounts, the Account field will be populated. You will be able to see the payment gateway customers on the account page.
![](../__attachments/2733998139/image-20230807-174915.png?inst-v=7859a023-5511-40be-b967-a1e2fed73946)
Account’s Payment Gateway Customer Screen
While the batch customer mapping links payment gateway customers to Salesforce accounts in a batch process, you can use the Account’s Payment Gateway Customer screen to link/create a payment gateway customer and download payment methods.
From the account page, click Payment Gateway Customer.
Choose a payment gateway connection and click Next. Then click Connect.
If the connection is successful:
The system will display the payment gateway on the screen, as well as all the connected payment gateway of the customer.
If the account is not connected to the payment gateway:
The system will perform a remote callout to the payment gateway to see if there are matching customers.
It is possible to default a Payment Gateway for the Account by populating the Default Payment Gateway field.
The system also performs another callout to pull the payment methods from the payment gateway. The last 2 columns show the record status of a payment method.
Remote:
Shows “Yes” if the payment method exists in the payment gateway.
Shows “No” if the payment method does not exist in the payment gateway.
Local:
Shows “Yes” if the payment method exists in Salesforce.
Shows “No” if the payment method does not exist in Salesforce.
Choose payment methods to download.
If the Remote is No and the Local is Yes, the checkbox is not available. This means the payment method was downloaded but later was deleted from the payment gateway.
Click the Save & Finish button to connect/create a payment gateway customer and download payment methods.
![](../__attachments/2733998139/image-20230830-034256.png?inst-v=7859a023-5511-40be-b967-a1e2fed73946)
It is possible to default a Payment Method for the Account by checking the Default field of a Payment Method record.