- Pautas de integración
- Implementación de una integración de Batch
- Conocer sus campos de información
Conocer sus campos de información
Antes de realizar una transacción de prueba, debe estar preparado con los valores de los campos que requieren su entrada. Independientemente del método que elija para generar estos valores, manual o generados de manera automática mediante un script, los valores adecuados para estos campos pueden simplificar el proceso de administrar pedidos y transacciones, sobre todo, recuperar transacciones perdidas.
Identificadores y referencias de transacciones/pedidos
Para obtener más información sobre los tipos de campos, las reglas de validación y qué operaciones requieren los siguientes campos, consulte la Referencia de API.
El identificador único de un pedido (incluido en la URL de REST), para distinguirlo de cualquier otro pedido que cree. Este campo es obligatorio y debe ser único para cada pedido que crea con respecto a su perfil de negocio. Al intentar realizar una transacción posterior contra un Pedido, por ejemplo, reembolso, captura o anulación, debe proporcionar el ID del Pedido que corresponde a la operación Authorization o Pay inicial.
Reutilización del identificador de pedido
Desde Web-Services API v15 en adelante, si la transacción inicial para un pedido falla, usted puede enviar otra transacción inicial para este pedido sin tener que crear un nuevo pedido. Esto es útil en escenarios donde al pagador desearía reintentar una transacción fallida con detalles de pago diferentes, por ejemplo: una tarjeta de crédito diferente o un método de pago alternativo (PayPal).
Identificador de una transacción (incluido en la URL para REST) para distinguirse de las demás transacciones dentro de este pedido. Este campo es obligatorio y debe ser único para transacciones que crea dentro de un pedido. Un ID de transacción único es útil para recuperar transacciones en una etapa posterior. Sin embargo, un ID de transacción siempre debe calificarse con el ID de pedido para una operación de recuperación satisfactoria.
El ID de transacción se muestra en la página Detalles de la transacción financiera en Merchant Administration como ID de transacción.
Referencia de API de identificador de transacción[REST][NVP]
Identificador opcional que se usa para proporcionar un identificador significativo basado en empresas en el American Express Payment Gateway. Por ejemplo, un número de carrito de compras, un número de pedido o un número de factura. La referencia de pedido se puede utilizar como criterio de búsqueda en Merchant Administration.
Identificador opcional que se usa para identificar la transacción dentro del American Express Payment Gateway. Este valor se establece en el nivel de transacción y no tiene restricciones de unicidad, por lo que puede utilizarse según sus necesidades. Puede buscar una transacción usando este campo en Merchant Administration.
Identificador temporal que se puede usar para hacer coincidir sus solicitudes al American Express Payment Gateway con las respuestas. El valor que proporciona no persiste en el motor de pagos y se devuelve tal como se proporciona en la respuesta a la solicitud. Puede utilizar el ID de correlación con todas las Web-Services API solicitudes.
Puede usar este valor para hacer coincidir las entradas en archivos de respuesta con las entradas correspondientes en archivos de solicitud, incluso cuando las respuestas se devuelven en un orden diferente a las solicitudes.