Configurar pasarelas de pago externas

Configuración inicial para configurar la pasarela de pago externa

1. Cree una cuenta de comerciante de comercio electrónico en la pasarela de pago externa que desea implementar.
   1. Inicie sesión en su proveedor de pasarela de pago externo y agregue una cuenta de comerciante de comercio electrónico.
   2. Navegue a la sección de gestión de claves, desarrollador o configuración avanzada de su plataforma de pasarela de pago elegida y genere una clave de API o clave secreta.

      Su clave de API tendría el aspecto siguiente: AQEvhmfxJ43HaxxHw0m/n3Q5qf3Ve4pBCIBMV3dVwyD4zesmTx/rk8/RZRz2w0bDdqMQwV1bDb7kfNy1WIxIIkxgBw==-C5bPe6tPCqOM35AEGroDa54J1Bl9AnsQKrDsDofVlrk=-i1ibf$Hu2v>8jR:Y9nU.

   3. Anote el nombre de usuario de la cuenta de comerciante y la clave de API. Los necesita para crear las credenciales nombradas.
2. Cree sus clases de Apex de pasarela de pago en su organización de Salesforce.
   1. Obtenga los detalles de clase de adaptador de su proveedor de pasarela de pago o AppExchange.
      Para crear y configurar adaptadores de pasarela de pago, consulte Adaptadores de pasarela de pago. Para definir sus clases Apex, consulte Espacio de nombres de pagos comerciales.
   2. Guarde sus clases de Apex. Anote el nombre del adaptador cuando lo necesite para crear su proveedor de pasarela de pago.
3. Cree una credencial nombrada heredada en su organización de Salesforce para especificar parámetros de autenticación y la URL de su extremo de llamadas Apex.
   1. Especifique un nombre fácil de usar para la etiqueta y un identificador exclusivo para el nombre.
   2. Introduzca la URL de su pasarela de pago externa.
   3. Seleccione Principal nombrado como el tipo de identidad y Autenticación de contraseña como el protocolo de autenticación.
   4. Utilice su nombre de usuario de cuenta de comerciante como el nombre de usuario. Utilice la clave de API como contraseña según lo requiera su proveedor de pasarela de pago.
   5. Guarde las credenciales nombradas cuando las necesite para crear su pasarela de pago.
4. Registre su sitio de pasarela de pago externo en su organización de Salesforce para asegurarse de que las llamadas Apex desde la organización al sitio de pasarela de pago son correctas.
   1. Introduzca un nombre y una URL de su pasarela de pago externa.
   2. Marque el sitio como activo y guarde sus cambios.
5. Agregue su URL de pasarela de pago externa como una URL de confianza en su organización de Salesforce.
   1. Introduzca un nombre de API.
   2. Introduzca la URL de su pasarela de pago externa.
   3. Marque la URL como activa y guarde sus cambios.
6. Active y configure su sitio de Salesforce, de modo que pueda enviar y recibir notificaciones de pagos desde su pasarela externa.
   1. Introduzca una etiqueta, un nombre y una página de inicio para su sitio.
   2. Establezca la configuración de acceso público del sitio como Acceso de invitado a la API de pagos.
   3. Guarde los detalles de su sitio.

Configurar ajustes de notificación en su pasarela de pago externa

La pasarela de pago utiliza un webhook para enviar notificaciones a su adaptador de pasarela de pago. Un webhook es una combinación del extremo de su sitio y el Id. del proveedor de la pasarela de pago. Cree un webhook proporcionando una URL en la configuración de transporte de notificaciones estándar de su pasarela de pago externa.

1. Utilice esta URL para el extremo de su sitio, sustituyendo MyDomainName por el dominio y la URL de su sitio. Por ejemplo:
   https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify
2. Busque el Id. de su proveedor de pasarela de pago y anexe el parámetro de consulta ?provider=ID al extremo. Por ejemplo, https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify?provider=0cJR00000004CEhMAM
3. Introduzca el webhook en la configuración de notificación estándar de su pasarela de pago externa.

Configurar proveedor de pasarela de pago y pasarela de pago

Agregue un proveedor de pasarela de pago después de configurar su cuenta de comerciante, sus clases de adaptador y su sitio de Salesforce. A continuación, agregue una pasarela de pago en el proveedor de pasarela de pago.

1. Desde Configuración, en el cuadro Búsqueda rápida, introduzca Facturación y, a continuación, seleccione Paso 7: Configuraciones de pago en la Configuración guiada.
2. Amplíe el paso Configurar pasarelas de pago externas, haga clic en Configurar pasarelas de pago y luego haga clic en Configurar.
   

   Nota

   Para organizaciones de Salesforce creadas en Winter ’26, el botón Configurar pasarelas de pago en Paso 7: Configuraciones de pago de la configuración guiada de facturación, que redirige a los usuarios a la ficha Configuración de pasarela de pago, está disponible de forma predeterminada. Para organizaciones de Salesforce creadas antes de Winter ’26, la ficha Configuración de pasarela de pago no está disponible de forma predeterminada. Para solucionar este problema, cambie los parámetros de la ficha Configuración de pasarela de pago a Valor predeterminado activado.

3. Rellene estos campos para crear un proveedor de pasarela de pago.
   1. Introduzca un nombre y una etiqueta exclusivos para su proveedor de pasarela de pago.
   2. Seleccione la clase de adaptador Apex de la lista desplegable.
   3. Especifique su asistencia requerida para idempotency. Para obtener más detalles, consulte Directrices de impotencia.
   4. Guarde los detalles del proveedor de la pasarela de pago.
4. Rellene estos campos para agregar una pasarela de pago.
   1. Introduzca un nombre exclusivo para su pasarela de pago.
   2. Seleccione un proveedor de pasarela de pago desde la lista desplegable.
   3. Seleccione una credencial nombrada de la lista desplegable.
   4. Marque el estado de su pasarela de pago como Activo.
   5. Guarde los detalles de la pasarela de pago.

   Si ya tiene un proveedor de pasarela de pago existente, seleccione Paso 7: Configuraciones de pago en la Configuración guiada, amplíe el paso Configurar pasarelas de pago externas y haga clic en Configurar pasarelas de pago. En la página Configuración de pasarela de pago, haga clic en Pasarelas de pago y luego haga clic en Nuevo. Los pasos de configuración son los mismos.

Agregar múltiples métodos de pago

Configure la compatibilidad para métodos de pago como Cámara de compensación automatizada (ACH), Área de pagos en euros única (SEPA), Servicios de compensación automatizados de los banqueros (BACS) y Sistema de compensación electrónica masiva (BECS) en su pasarela de pago externa. Puede procesar pagos, emitir reembolsos y ver estos métodos de pago guardados en la ficha Métodos de pago guardados de su perfil de facturación.

• Para agregar métodos de pago bancarios como ACH, SEPA, BACS y BECS, utilice la API tokenizePaymentMethod y establezca la propiedad bankType en el objeto bankPaymentMethod como su método de pago bancario elegido.
• Para agregar métodos de pago de tarjeta como tarjeta de crédito o tarjeta de débito, utilice la API tokenizePaymentMethod y establezca la propiedad cardCategory en el objeto cardPaymentMethod.