merchant_id correcto se resuelva automáticamente al momento del pago.
Un comercio que opera varias tiendas franquiciadas puede asignar credenciales de proveedor distintas (por ejemplo, CIELO_456 para Cielo, ADYEN_789 para Adyen) a cada tienda, y el sistema elegirá la correcta según el proveedor que procese el pago.
Conceptos clave
- Alcance organizacional: un seller se crea bajo un
account_codeespecífico, pero está disponible en toda la organización: cualquier cuenta de la misma organización puede hacer referencia a ese seller en las solicitudes de pago. - Resolución sin bloqueo: la resolución de franquicia nunca bloquea un pago. Si no existe ningún mapeo o el servicio no está disponible, el pago continúa con el
merchant_idpredeterminado de la conexión. - Detalle polimórfico: el arreglo
payment_methodusa una estructuradetailpolimórfica. La forma del objeto detail depende del campopayment_method_type(CARD→detail.card.provider,APPLE_PAY→detail.wallet.provider). - Eliminación lógica: eliminar un seller realiza una eliminación lógica del registro y de todos los datos de método de pago asociados. Los pagos anteriores no se ven afectados.
Autenticación
Todos los endpoints de la API de Sellers requieren los siguientes encabezados:Reglas de negocio
- Unicidad: un seller por
(account_code, merchant_seller_id). Dentro de un seller, cada(provider.id, payment_method_type)debe ser único. - Varias tiendas: un comercio puede registrar varios valores de
merchant_seller_id(uno por tienda franquiciada). - Varios proveedores: cada seller puede tener entradas de
payment_methodpara varios proveedores y tipos de método de pago. - Referencia al seller: los pagos hacen referencia a los sellers mediante
seller_id(UUID de Yuno) omerchant_seller_id(identificador del comercio), mutuamente excluyentes. - Sobrescritura de campos: los campos del seller enviados en una solicitud de pago sobrescriben los valores almacenados solo para ese pago, sin guardarse de nuevo.
- Prioridad de resolución: el mapeo del seller tiene prioridad sobre el
merchant_idde la conexión. Si no existe ningún mapeo, se usa elmerchant_idoriginal. - Alcance organizacional: los mapeos de sellers están disponibles a nivel de organización: cualquier cuenta de la organización puede usar cualquier seller registrado bajo esa organización.
- Indicador “Operates as Franchise”: cuando está habilitado en una conexión, la lógica de integración usa el
merchant_iddel mapeo de franquicia en lugar delmerchant_idde la conexión. - Eliminación lógica: eliminar un seller realiza una eliminación lógica del registro y de todos los datos de método de pago. Los pagos anteriores no se ven afectados. Los pagos futuros recurren al
merchant_idpredeterminado de la conexión. - Compatibilidad con versiones anteriores: cuando ninguno de los dos campos de referencia al seller está presente, la función se omite por completo.
El objeto Seller
Comprende la estructura y los atributos de una identidad de seller.
Uso de sellers en pagos
Aprende a hacer referencia a los sellers en tus solicitudes de pago.