Puntos de extensión xC de pago
Puede personalizar cómo HCL Commerce se integra con pasarelas de pago de terceros. Utilice estos puntos de extensión para personalizar cómo HCL Commerce interactúa con las pasarelas de pago para procesar pagos durante la captura de pedidos.
La tabla siguiente identifica las clases para los mandatos relacionados con pagos punch-out que puede personalizar mediante una extensión de la externalized customization.
Para obtener un ejemplo de cómo registrar el código de extensión y asignar el código al punto de extensión, consulte Habilitación del pago Punch-out.| Punto de extensión | Dónde se utiliza el punto de extensión | Sugerencias de implementación de código de extensión | Formatos de solicitud, respuesta | Ejemplo de ubicación de código de extensión |
|---|---|---|---|---|
| approve_payment | La operación para pasar por caja el carro de la compra (POST cart/@self/checkout) llama al punto de extensión approve_payment para autorizar el pago. | El punto de extensión approve_payment debe devolver la transacción financiera con su estado establecido en 1 (pendiente) para iniciar el pago punch-out. | PaymentApproveCmdUEInput, PaymentApproveCmdUEOutput |
El método approvePayment enworkspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| get_punchout_url | La operación de información para obtener pago punch-out (GET cart/@self/payment_instruction/punchoutPaymentInfo) llama al punto de extensión get_punchout_url para obtener el URL de formulario de pago. | El código de extensión get_punchout_url debe devolver el URL de formulario de pago. | GetPunchoutURLCmdUEInput, GetPunchoutURLCmdUEOutput |
El método getPunchoutURL enworkspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| process_punchout_response | La operación de retrollamada (POST cart/@self/payment_instruction/callback) llama al punto de extensión process_punchout_response para procesar parámetros de retrollamada del proveedor de servicios de pago. | El código de extensión process_punchout_response debe llamar al proveedor de servicios de pago para verificar los parámetros de retrollamada, devolver los parámetros de respuesta con el parámetro "punchoutTranResult" establecido en "successful", "failed" o "invalid" y actualizar los datos ampliados de la instrucción de pago para incluir información adicional. | ProcessPunchoutResponseCmdUEInput, ProcessPunchoutResponseCmdUEOutput |
El método processPunchoutResponse enworkspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
La tabla siguiente identifica las clases para la señalización de pago que puede personalizar a través de una extensión de la externalized customization.
Para obtener un ejemplo de cómo registrar el código de extensión y asignar el código al punto de extensión, consulte Habilitación de la tokenización de pagos.
| Punto de extensión | Dónde se utiliza el punto de extensión | Sugerencias de implementación de código de extensión | Formatos de solicitud, respuesta | Ejemplo de ubicación de código de extensión |
|---|---|---|---|---|
| create_payment_token | La operación para añadir instrucción de pago (POST cart/@self/payment_instruction) o la operación para actualizar el perfil de pasar por caja (PUT person/@self/checkoutProfile) llama al punto de extensión create_payment_token para crear la señal de pago. | El código de extensión create_payment_token debe llamar al proveedor de servicios de pago para tokenizar la información de pago en los datos de protocolo y devolver la seña de pago y su valor de visualización como pares clave-valor "payment_token" y "display_value" in the token data. | CreatePaymentTokenCmdUEInput, CreatePaymentTokenCmdUEOutput | El método createPaymentToken enworkspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| update_payment_token | La operación para actualizar instrucción de pago (PUT cart/@self/payment_instruction) o la operación para actualizar el perfil de pasar por caja (PUT person/@self/checkoutProfile) llama al punto de extensión update_payment_token para crear la señal de pago. | El código de extensión update_payment_token debe llamar al proveedor de servicios de pago para retokenizar los datos de señal existentes con la información de pago actualizada en los datos de protocolo y devolver la señal de pago actualizada y su valor de visualización como pares clave-valor "payment_token" y "display_value" en los datos de señal. | UpdatePaymentTokenCmdUEInput, UpdatePaymentTokenCmdUEOutput | El método updatePaymentToken enworkspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| remove_payment_token | La operación para suprimir instrucción de pago (DELETE cart/@self/payment_instruction/{piId}) llama al punto de extensión remove_payment_token para eliminar la señal de pago. | El código de extensión remove_payment_token debe llamar al proveedor de servicios de pago para eliminar la señal de pago (como el par clave-valor "payment_token" en los datos de señal) de su base de datos. | RemovePaymentTokenCmdUEInput, RemovePaymentTokenCmdUEOutput | El método removePaymentToken enworkspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| approve_payment | La operación para pasar por caja el carro de la compra (POST cart/@self/checkout) llama al punto de extensión approve_payment para autorizar el pago. | El código de extensión approve_payment extension debe llamar al proveedor de servicios de pago con los datos de señal guardados en los datos de protocolo para procesar el pago y devolver la transacción financiera actualizada con su estado establecido en 2 (success) o 3 (failed). | PaymentApproveCmdUEInput, PaymentApproveCmdUEOutput | El método createPaymentToken en workspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
Nota: El método encryptByMD5 para PunchoutPaymentUtil está en desuso desde la versión 7 de WebSphere Commerce y se eliminará ahora. Debe personalizar el código si utiliza el mismo método.