Skip to main content

5.7 Revisando el estado de una orden

“CCTRANSUPDATE” puede ser utilizado para actualizar datos en elementos específicos de una orden. Actualmente, solo TRANS_CUST_RECEIPT está disponible para ser actualizado. Para actualizar una orden con recibo, los comercios deben configurar el parámetro REQUEST_ACTION como “CCTRANSUPDATE” junto con una referencia a la orden, ya sea en el parámetro REQUEST_REF_PO_ID (haciendo referencia al PO_ID de una orden anterior) o en el parámetro REQUEST_REF_PO_ID_XTL (Haciendo referencia al XTL_ORDER_ID de una orden anterior).

5.7.1 Ejemplo de solicitud CCTRANSUPDATE utilizando REQUEST_REF_PO_ID​

/pmt_service.cfm?req_password=P5ssword1&site_id=1234&request_ref_po_id=1234567&request_response_format=JSON&req_username=test1%40example.net&request_api_version=4.4&request_action= CCTRANSUPDATE&mbshp_id_xtl=1502&trans_customer_receipt=aHR0cHM6Ly9udXRyaXN5cy5yZWMudHJhbnNfaWQyMzQ=

5.7.2 Ejemplo de solicitud CCTRANSUPDATE utilizando REQUEST_REF_PO_ID_XTL​

/pmt_service.cfm?req_password=P5ssword1&site_id=1234&request_ref_po_id_xtl=order123&request_response_format=JSON&req_username=test1%40example.net&request_api_version=4.4&request_action=CCTRANSUPDATE&mbshp_id_xtl=1502&trans_customer_receipt=aHR0cHM6Ly9udXRyaXN5cy5yZWMudHJhbnNfaWQyMzQ=

5.7.3 Ejemplo de respuesta CCTRANSUPDATE​

el ejemplo de respuesta siguiente muestra que el orden se capturó y luego se invirtió. Los comerciantes pueden hacer referencia a la TRANS_STATUS_NAME en la comprobación del estado de una solicitud de transacción específica.

<RESPONSE>
    <TRANSACTION TRANS_ID="43500">
        <REQUEST_ACTION>CCAUTHORIZE</REQUEST_ACTION>
        <TRANS_STATUS_NAME>APPROVED</TRANS_STATUS_NAME> 
        <TRANS_VALUE>10</TRANS_VALUE> 
        <CUST_ID>1500</CUST_ID>
        <XTL_CUST_ID/>
        <PO_ID>1234567</PO_ID>
        <XTL_ORDER_ID> order123</XTL_ORDER_ID> 
        <BATCH_ID>1001</BATCH_ID>
        <PROC_NAME>Test Processor</PROC_NAME> 
        <MERCH_ACCT_ID>100</MERCH_ACCT_ID> 
        <CARD_BRAND_NAME>Visa</CARD_BRAND_NAME> 
        <PMT_L4>3762</PMT_L4>
        <PROC_UDF01/>
        <PROC_UDF02/> 
        <PROC_AUTH_RESPONSE>46177</PROC_AUTH_RESPONSE> 
        <PROC_RETRIEVAL_NUM>56789AB</PROC_RETRIEVAL_NUM> 
        <PROC_REFERENCE_NUM/> 
        <AVS_RESPONSE>M</AVS_RESPONSE> 
        <CVV_RESPONSE>M</CVV_RESPONSE>
        <MBSHP_ID_XTL>1502</MBSHP_ID_XTL> 
    </TRANSACTION>
</RESPONSE>

5.7.4 Campos de respuesta CCTRANSUPDATE​

  • TRANS_ID – ID único de transacción.
  • REQUEST_ACTION – Esto retornará la Acción de solicitud de servicio que el comercio envió en la solicitud de transacción.
  • TRANS_STATUS_NAME – Estado de transacción.
  • TRANS_VALUE – Cantidad total de transacción de todas las líneas de artículo.
  • CUST_ID – ID de cliente.
  • XTL_CUST_ID- ID del cliente del comercio.
  • PO_ID – ID de orden de compra.
  • XTL_ORDER_ID – ID de orden del comercio.
  • BATCH_ID – ID del corte.
  • PROC_NAME – Nombre del procesador.
  • MERCH_ACCT_ID – ID de cuenta bancaria del comercio.
  • CARD_BRAND_NAME – Cuenta de banco o tipo de tarjeta de crédito (Ejemplo: “Mastercard”). - PMT_L4 – Cuenta de pago o últimos 4 dígitos de la tarjeta de crédito.
  • PMT_ID –ID de pago
  • PMT_ID_XTL – ID externo de pago
  • PROC_UDF01 – Campo definido por el usuario del procesador #1
  • PROC_UDF02 – Campo definido por el usuario del procesador #2
  • PROC_AUTH_RESPONSE – Código de respuesta de autorización del procesador.
  • PROC_RETRIEVAL_NUM – Número de recuperación del procesador o GUID
  • PROC_REFERENCE_NUM – Número de referencia del procesador.
  • AVS_RESPONSE – Código de respuesta del servicio de verificación de dirección.
  • CVV_RESPONSE – Código de respuesta de CVV.
  • REQUEST_API_VERSION – Versión de API del servicio de pagos (4.4).
  • PO_LI_ID_X – ID de orden de compra de línea de artículo.
  • PO_LI_COUNT_X – Cantidad de líneas de artículo de la orden de compra.
  • PO_LI_AMOUNT_X – Valor total de los artículos en la línea x.
  • PO_LI_PROD_ID_X – ID de producto del artículo de la línea x.
  • MBSHP_ID – ID de membresía (retornado en transacciones de membresía)
  • MBSHP_ID_XTL – ID de membresía del cliente, recibida por el comercio.