Настройка сторонних шлюзов оплаты

Первичная настройка стороннего шлюза оплаты

1. Создайте организацию-коммерсанта в стороннем шлюзе оплаты, который нужно внедрить.
   1. Войдите в систему стороннего поставщика шлюза оплаты и добавьте организацию-коммерсанта электронной торговли.
   2. Перейдите в раздел управления ключами, разработчика или расширенных параметров выбранной платформы шлюза оплаты и создайте ключ API или секретный ключ.

      Ваш ключ API будет выглядеть следующим образом: AQEvhmfxJ43HaxxHw0m/n3Q5qf3Ve4pBCIBMV3dVwyD4zesmTx/rk8/RZRz2w0bDdqMQwV1bDb7kfNy1WIxIIkxgBw==-C5bPe6tPCqOM35AEGroDa54J1Bl9AnsQKrDsDofVlrk=-i1ibf$Hu2v>8jR:Y9nU.

   3. Запишите имя пользователя торговой организации и ключ API. Они нужны для создания именованных регистрационных данных.
2. Создайте классы Apex шлюза оплаты в организации Salesforce.
   1. Получите сведения о классе адаптера у поставщика шлюза оплаты или AppExchange.
      Для создания и настройки адаптеров шлюза оплаты см. «Адаптеры шлюза оплаты». Чтобы определить классы Apex, см. Пространство имен Commerce Payments.
   2. Сохраните классы Apex. Запишите имя адаптера, которое вам нужно для создания поставщика шлюза оплаты.
3. Создайте устаревшие именованные регистрационные данные в организации Salesforce, чтобы указать параметры проверки подлинности и URL-адрес конечной точки выноски Apex.
   1. Укажите удобное имя метки и уникальный идентификатор имени.
   2. Введите URL-адрес стороннего шлюза оплаты.
   3. Выберите «Названный субъект» в качестве типа удостоверения и «Проверка подлинности паролей» в качестве протокола проверки подлинности.
   4. Используйте имя пользователя торговой организации в качестве имени пользователя. Используйте ключ API в качестве пароля, согласно требованиям поставщика шлюза оплаты.
   5. Сохраните именованные регистрационные данные, необходимые для создания шлюза оплаты.
4. Зарегистрируйте сторонний сайт шлюза оплаты в организации Salesforce, чтобы убедиться в успешности выносок Apex из организации на сайт шлюза оплаты.
   1. Введите имя и URL-адрес стороннего шлюза оплаты.
   2. Отметьте сайт активным и сохраните изменения.
5. Добавьте URL-адрес стороннего шлюза оплаты в качестве надежного URL-адреса в организацию Salesforce.
   1. Введите имя API.
   2. Введите URL-адрес стороннего шлюза оплаты.
   3. Отметьте URL-адрес активным и сохраните изменения.
6. Включите и настройте сайт Salesforce, чтобы отправлять и получать уведомления об оплате из стороннего шлюза.
   1. Введите метку, имя и начальную страницу сайта.
   2. Задайте параметрам общего доступа сайта значение «Гостевой доступ к API платежей».
   3. Сохраните сведения о сайте.

Настройка параметров уведомлений в стороннем шлюзе оплаты

Шлюз оплаты использует вебхук для отправки уведомлений в адаптер шлюза оплаты. Вебхук - это сочетание конечной точки сайта и кода поставщика шлюза оплаты. Создайте вебхук, предоставив URL-адрес в стандартных параметрах транспортировки уведомлений стороннего шлюза оплаты.

1. Используйте этот URL-адрес для конечной точки сайта, заменив MyDomainName доменом и URL-адресом сайта. Например:
   https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify
2. Найдите код поставщика шлюза оплаты и добавьте параметр запроса ?provider=ID к конечной точке. Например, https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify?provider=0cJR00000004CEhMAM
3. Введите вебхук в стандартные параметры уведомлений стороннего шлюза оплаты.

Настройка поставщика шлюза оплаты и шлюза оплаты

Добавьте поставщика шлюза оплаты после настройки организации торгового представителя, классов адаптера и сайта Salesforce. Потом добавьте шлюз оплаты в поставщика шлюза оплаты.

1. Введите строку «Выставление счета» в поле «Быстрый поиск» меню «Настройка» и выберите пункт «Шаг 7: Конфигурации оплаты» в пошаговом руководстве.
2. Разверните шаг «Настроить сторонние шлюзы оплаты», нажмите «Настроить шлюзы оплаты», а потом нажмите «Настроить».
   

   Примечание

   В организациях Salesforce, созданных в выпуске Winter ’26, кнопка «Настроить шлюзы оплаты» в шаге 7: конфигурации оплаты пошагового руководства по выставлению счета, которая перенаправляет пользователей во вкладку конфигурации шлюза оплаты, доступна по умолчанию. В организациях Salesforce, созданных до выпуска Winter ’26, вкладка конфигурации шлюза оплаты недоступна по умолчанию. Чтобы исправить эту проблему, измените параметры вкладки «Конфигурация шлюза оплаты» на «Включены стандартные параметры».

3. Заполните эти поля, чтобы создать поставщика шлюза оплаты.
   1. Введите уникальное имя и метку поставщика шлюза оплаты.
   2. Выберите класс адаптера Apex в раскрывающемся списке.
   3. Укажите обязательную поддержку импотенции. Дополнительные сведения см. в разделе Рекомендации по идемпотентности.
   4. Сохраните сведения о поставщике шлюза оплаты.
4. Заполните эти поля, чтобы добавить шлюз оплаты.
   1. Введите уникальное имя шлюза оплаты.
   2. Выберите поставщика шлюза оплаты в раскрывающемся списке.
   3. Выберите именованные регистрационные данные в раскрывающемся списке.
   4. Отметьте статус шлюза оплаты активным.
   5. Сохраните сведения о шлюзе оплаты.

   Если у вас уже есть существующий поставщик шлюза оплаты, выберите Шаг 7: Конфигурации оплаты в пошаговом руководстве, разверните шаг «Настроить сторонние шлюзы оплаты» и нажмите «Настроить шлюзы оплаты». На странице конфигурации шлюза оплаты нажмите «Шлюзы оплаты», а потом нажмите «Создать». Этапы конфигурации одинаковые.

Добавление нескольких методов оплаты

Настройте поддержку таких методов оплаты, как Автоматический расчетный центр (ACH), Единая зона платежей в евро (SEPA), Автоматические клиринговые службы банкиров (BACS) и система пакетного электронного клиринга (BECS) в стороннем платежном шлюзе. Вы можете обрабатывать платежи, выдавать возмещения и просматривать эти сохраненные методы оплаты во вкладке сохраненных методов оплаты профиля выставления счета.

• Чтобы добавить банковские методы оплаты, например, ACH, SEPA, BACS и BECS, используйте API tokenizePaymentMethod и установите свойство bankType в объекте bankPaymentMethod на выбранный банковский метод оплаты.
• Чтобы добавить методы оплаты картой, например, кредитной или дебетовой картой, используйте API tokenizePaymentMethod и задайте свойство cardCategory в объекте cardPaymentMethod.