Procesamiento por lotes
Permite a los usuarios ejecutar operaciones masivas de reembolso, captura y anulación de transacciones mediante la carga de un archivo CSV. Esta herramienta facilita la gestión eficiente de un gran volumen de transacciones, simplificando procesos que de otro modo serían manuales y repetitivos.
Operaciones Soportadas
Las operaciones que se pueden realizar a través de Procesamiento por lotes son las siguientes:
- Reembolso: Permite devolver el monto total o parcial de una transacción.
- Captura: Confirma la retención de fondos previamente autorizados.
- Anulación: Cancela una transacción autorizada antes de que se capture el dinero.
Paso 1: Descarga del Template
Para garantizar que los datos cargados sean correctos y sigan el formato requerido, el sistema ofrece un archivo CSV de ejemplo para cada una de las operaciones(template). Este template contiene los campos necesarios para cada operación soportada.
- Accede a la sección de Batch Processing.
- Descarga el template CSV correspondiente a la operación que deseas ejecutar (reembolso, captura o anulación).
- Completa el template con los datos de las transacciones que deseas procesar. Asegúrate de que los valores ingresados respeten el formato de cada columna (por ejemplo, ID de transacción, monto, etc.).
Template reembolso
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| batch_id | header | Identificador único asignado por el usuario, este no podrá repetirse por lote. |
| transaction_type | header | En el caso del template de reembolso el valor debe ser refund |
| reason | header | El usuario podrá especificar por lote, una razón para la operación. (por ejemplo, cancelación de vuelo) |
| transaction_id | row | Identificador único de la transacción que se desea reembolsar. |
| currency | row | Moneda de la transacción (por ejemplo, USD, MXN). |
| amount_to_refund | row | Monto a reembolsar (parcial o total). Se debe incluir el valor de centavos, sin comas o puntos. (por ejemplo, 1226,00 USD, se debe ingresar el monto 122600) |
Template captura
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| batch_id | header | Identificador único asignado por el usuario, este no podrá repetirse por lote. |
| transaction_type | header | En el caso del template de captura el valor debe ser capture |
| transaction_id | row | Identificador único de la transacción que se desea reembolsar. |
| currency | row | Moneda de la transacción (por ejemplo, USD, MXN). |
| amount_to_refund | row | Monto a reembolsar (parcial o total). Se debe incluir el valor de centavos, sin comas o puntos. (por ejemplo, 1226,00 USD, se debe ingresar el monto 122600) |
Template anulación
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| batch_id | header | Identificador único asignado por el usuario, este no podrá repetirse por lote. |
| transaction_type | header | En el caso del template de anulación el valor debe ser void |
| transaction_id | row | Identificador único de la transacción que se desea reembolsar. |
Paso 2: Carga del archivo
Una vez completado el archivo CSV, el siguiente paso es cargarlo, en la sección de Procesamiento por Lote:
- Selecciona el botón Subir lote
- Asigna un nombre para la carga del archivo
- Sube el archivo CSV
- Da clic en Validar
Estado del lote
Después de cargar el archivo, el sistema pasará por un proceso de validación. Los posibles estados del archivo son los siguientes:
| Estado | Descripción | Acción requerida |
|---|---|---|
| Validando | El archivo ha sido subido y está siendo validado. | N/A |
| Por Resolver | El archivo tiene errores que requieren intervención manual. | Corregir los errores y volver a subir el archivo. |
| Rechazado | El archivo ha fallado la validación. | Revisar y corregir los errores indicados y volver a subir el archivo. |
| Procesando | El archivo ha pasado la validación y está siendo procesado. | Ninguna, esperar a que el procesamiento finalice. |
| Completado | El procesamiento del archivo ha finalizado. | Revisar los resultados en el archivo de respuesta. |
Errores de archivos
Si el archivo contiene errores, el usuario podrá descargar un archivo con el detalle de los errores por archivo o por transacción. A continuación se detallan los posibles errores y sus categorías:
| Categoría | Nombre del error | Descripción | Código de Error |
|---|---|---|---|
| WrongFileFormat | EmptyRow | Campo vacío requerido para ejecutar la operación. | BT1 |
| WrongFileArguments | EmptyRow | Campo vacío requerido para ejecutar la operación. | BT2 |
| WrongFileFormat | WrongRowFormat | Formato erroneo en una columna. | BT3 |
| WrongFileFormat | MissingBatchIDHeader | Se requiere incluir el Batch ID en el header. | BT4 |
| WrongFileFormat | MissingTransactionTypeHeader | Se requiere incluir el Transaction Type en el header. | BT5 |
| WrongFileFormat | MissingEmptyRow | La segunda linea del file debe estar vacía. Se recomienda bajar el template. | BT6 |
| WrongFileFormat | MissingDataRowsHeader | Se requiere incluir los headers obligatorios del template. | BT7 |
| WrongFileFormat | MissingOrderTokenHeader | Se requiere incluir transaction id en el header. Se recomienda bajar el template. | BT8 |
| WrongFileFormat | MissingCurrencyHeader | Se requiere incluir currency en el header. Se recomienda bajar el template. | BT9 |
| WrongFileFormat | MissingAmountToCaptureHeader | Se requiere incluir amount_to_capture en el header. Se recomienda bajar el template. | BT10 |
| WrongFileFormat | MissingAmountToRefundHeader | Se requiere incluir amount_to_refund en el header. Se recomienda bajar el template. | BT11 |
| WrongFileArguments | InvalidBatchID | El Batch ID es invalido. | BT12 |
| WrongFileArguments | InvalidTransactionType | El transaction type ingresado es invalido. | BT13 |
| WrongFileFormat | InvalidOrderToken | El transaction id ingresado es invalido. | BT14 |
| WrongFileFormat | InvalidCurrency | El currency ingresado es invalido. | BT15 |
| WrongFileFormat | InvalidAmount | El monto ingresado es invalido. | BT16 |
| WrongFileFormat | CurrencyHeaderShouldBeEmpty | El archivo de template de anulación, no debe contener currency en el header. Se recomienda bajar template. | BT17 |
| WrongFileFormat | CurrencyShouldBeEmpty | El archivo de template de anulación, no debe contener valor de currency en el header. Se recomienda bajar template. | BT18 |
| WrongFileFormat | AmountHeaderShouldBeEmpty | El archivo de template de anulación, no debe contener amount en el header. Se recomienda bajar template. | BT19 |
| WrongFileFormat | AmountShouldBeEmpty | El archivo de template de anulación, no debe contener valor de amount en el header. Se recomienda bajar template. | BT20 |
Updated 8 months ago