Skip to main content
El registro masivo permite dar de alta o actualizar cientos de comercios en un solo proceso, cargando un archivo Excel a un bucket S3 asignado a tu organización. El sistema procesa cada fila de forma asíncrona y genera un archivo de resultados con el detalle de cada operación.

Ambientes

El nombre del archivo debe seguir el formato: OMasivo_*.xlsx

Flujo de registro masivo

1

Prepara el archivo Excel

Completa el archivo de entrada con los datos de cada comercio. Cada fila puede ser INSERT para nuevos comercios o UPDATE para actualizar existentes.
2

Sube el archivo a S3

Carga el archivo en la carpeta /IN/ del bucket S3 asignado a tu organización.
3

El sistema procesa el archivo

Pay-me procesa cada fila de forma asíncrona — valida los datos, registra los comercios y habilita sus métodos de pago.
4

Descarga el archivo de resultados

Una vez procesado, el archivo de salida aparece en la carpeta /OUT/ con el resultado de cada fila — exitosos, fallidos y credenciales generadas.

Operaciones soportadas por fila

INSERT

Crea un nuevo comercio. Genera client_id y client_secret incluidos en el archivo de salida.

UPDATE

Actualiza datos de un comercio existente usando su merchant_code. No regenera credenciales ni modifica datos fiscales.

Estructura del archivo de salida

El archivo de salida incluye todas las columnas del archivo de entrada más los siguientes campos de resultado:

Consideraciones

Si una fila tiene errores de validación, el campo status será error y message describirá el motivo — por ejemplo: "RUC inválido" o "marca no permitida".
En operaciones UPDATE, los datos fiscales no son modificables y las credenciales no se regeneran.

Referencia técnica

Ver referencia en GitHub

Estructura de entrada · Estructura de salida · Archivos de ejemplo