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

AmbienteBucket S3 entradaBucket S3 salida
Desarrolloadq-massive-onboarding/payment-facilitator/{PF_CODE}/IN/adq-massive-onboarding/payment-facilitator/{PF_CODE}/OUT/
Producciónadq-massive-onboarding/payment-facilitator/{PF_CODE}/IN/adq-massive-onboarding/payment-facilitator/{PF_CODE}/OUT/
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:
CampoDescripción
statussuccess o error por fila
messageDetalle del resultado o motivo del error
merchant_codeUUID asignado al comercio
merchant_credentialsclient_id y client_secret generados — solo en INSERT
payment_methods_enabledMétodos habilitados exitosamente
payment_methods_failedMétodos que fallaron durante el registro

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