- Pautas de integración
- Implementación de una integración de Batch
- Crear la solicitud de lote
Crear la solicitud de lote
Crear la solicitud de lote es un paso crítico en la integración del negocio. Una solicitud de lote consta de un archivo de lote en formato nativo, que el servicio de Batch acepta y envía a la URL de Batch de American Express Payment Gateway mediante HTTPS PUT.
El formato nativo se define de la siguiente manera:
- El encabezado HTTP debe especificar autenticación básica e incluir su contraseña de integración base64 codificada.
- La codificación de caracteres de su solicitud debe incluir solo formatos ISO-8859-1 (Latin1) o UTF-8. Consulte Asegurar codificación de caracteres.
- Los archivos de lote deben suministrarse en el formato CSV delimitado por comas y tener en cuenta las siguientes restricciones de procesamiento:
- No deben incluirse comentarios, ya que no son compatibles.
- No se recortan los espacios iniciales ni finales en los valores.
- Las comas incrustadas deben administrarse al incluir el valor entre comillas.
- Las comillas dobles incrustadas deben administrarse al incluir el valor entre comillas y luego representarlo por un par de comillas dobles.
- Existe una longitud de valor máxima de 100,000 caracteres por línea.
- Cada archivo de lote debe contener una fila de encabezado único con valores que correspondan a los nombres de campo de protocolo NVP de Web-Services API. Consulte Referencia de NVP.
- Los campos dentro del archivo de datos obedecen las reglas de validación de Web-Services API (longitud de campo y formato, valor único obligatorio, etc.).
- Se pueden proporcionar dentro de un archivo los registros para todos los tipos de transacción (autorización, compras, capturas, reembolsos, anulaciones). No obstante, asegúrese de que los tipos de transacción NO estén relacionados con el mismo pedido, es decir, que no contengan el mismo identificador de pedido. Para obtener más información, consulte Mejores prácticas y consejos
En el ejemplo siguiente se muestra un archivo de introducción de lote de prueba para un negocio que usa una contraseña como mecanismo de autenticación para conectarse a American Express Payment Gateway.
apiOperation,order.id,order.currency,transaction.id,transaction.amount,transaction.currency,sourceOfFunds.type,sourceOfFunds.provided.card.number,sourceOfFunds.provided.card.expiry.month,sourceOfFunds.provided.card.expiry.year,response.gatewayCode,result,error.cause,error.explanation,error.field,error.supportCode,error.validationType PAY,921830104177,TXID1,30,AUD,CARD,5123456789012346,05,17,,,,, PAY,921830104178,TXID1,100,AUD,CARD,5123456789012346,05,17,,,,, PAY,921830104179,TXID1,50,AUD,CARD,4987654321098769,05,17,,,,, PAY,921830104180,TXID1,90,AUD,CARD,4987654321098769,05,17,,,,, PAY,936742085167,AUD,TX1,30.00,AUD,CARD,5123456xxxxxx346,05,21,,,, PAY,936742085168,AUD,TX1,35.00,AUD,CARD,5123456xxxxxx346,05,21,,,,
Se ha incluido en el código de ejemplo el código de muestra para una integración básica de Batch. Consulte Descargas.
El paso siguiente es enviar la solicitud de lote.