additional_data.seller_details. El sistema resuelve automáticamente el merchant_id correcto al momento del pago, según el proveedor que procesa el pago.
Referenciar un seller
Puedes referenciar un seller con cualquiera de los dos identificadores (son mutuamente excluyentes: envía uno u otro):Ejemplo: pago con merchant_seller_id
Ejemplo: pago con campos sobrescritos
Cuando envías campos adicionales del seller junto con la referencia al seller, esos campos sobrescriben los valores almacenados del seller solo para ese pago. No se guardan de nuevo en el mapeo del seller.Cómo funciona la resolución
- El comercio envía una solicitud de pago con
merchant_seller_idoseller_iddentro deadditional_data.seller_details. - El pago fluye por el pipeline estándar. El enrutamiento selecciona un proveedor (por ejemplo, Cielo).
- Después del enrutamiento, el sistema busca el mapeo de franquicia por
(organization, seller_identifier, provider, payment_method_type). - Si lo encuentra: el
merchant_idde la conexión se sobrescribe con elmerchant_idresuelto. Cualquier campo del seller enviado en la solicitud sobrescribe los valores almacenados para este pago. - Si no lo encuentra o el servicio no está disponible: el pago continúa con el
merchant_idpredeterminado de la conexión (fallback controlado).
Retrocompatibilidad
Cuando no hay niseller_id ni merchant_seller_id, se omite por completo la función de franquicias: sin impacto en los flujos existentes.