Actualizar destinatario
Actualiza los detalles de un destinatario de marketplace existente, identificado por su recipient_id.
Actualizaciones de cuenta bancaria
Para los onboardings de Zoop y Pagar.me con un ID de destinatario del proveedor, una actualización explícita dewithdrawal_methods.bank espera el resultado del proveedor. Los demás campos del destinatario conservan su comportamiento de actualización actual.
Sin onboarding_id, Yuno combina los campos bancarios que envías con la cuenta bancaria guardada del destinatario para formar una sola cuenta para los onboardings elegibles. No combina tu solicitud con la cuenta bancaria distinta de cada proveedor. Envía una cuenta completa si la cuenta guardada no aporta los campos faltantes. Los tipos de cuenta aceptados son CHECKINGS y SAVINGS.
Con onboarding_id, la actualización bancaria se dirige solo a ese onboarding y deja sin cambios el valor predeterminado del destinatario y los demás onboardings. Los campos omitidos se toman de la cuenta guardada del onboarding, o del valor predeterminado del destinatario si el onboarding no tiene un registro bancario guardado. Si el onboarding no muestra ninguna cuenta bancaria, envía una cuenta completa.
Por ejemplo, una tienda cambia su cuenta de payout de A a B. Zoop confirma B, pero Pagar.me no confirma el cambio. Yuno mantiene B para Zoop, conserva la cuenta guardada anterior de Pagar.me y actualiza el valor predeterminado del destinatario a B. La solicitud devuelve un error que describe los resultados. Un error no significa que todos los proveedores hayan quedado sin cambios. Los cambios exitosos de los proveedores no se revierten.
El valor predeterminado del destinatario avanza después de que al menos un proveedor confirma la actualización. Si todos los proveedores intentados la rechazan o tienen un resultado desconocido, se mantiene el valor predeterminado anterior. Cuando no hay ningún destino elegible vinculado a un proveedor, la cuenta puede guardarse localmente. Leer una cuenta guardada desde Yuno no es una confirmación independiente de un resultado desconocido del proveedor.
Las actualizaciones bancarias no se aplican a los onboardings en ERROR, BLOCKED, CANCELLED, INACTIVE, TRANSFERRED o TERMINATED. Dirigirse a uno de ellos (con onboarding_id, Actualizar onboarding o Continuar onboarding) devuelve 400 INVALID_STATE; una actualización a nivel de destinatario sin onboarding_id los omite y conserva su cuenta anterior.
Errores bancarios y reintentos
Autorizaciones
Cuerpo
ID de un onboarding existente que pertenece al destinatario. Cuando se establece, los campos de identidad enviados en esta solicitud (por ejemplo, first_name, email, phone, address) se almacenan como una sobrescritura por onboarding solo para ese onboarding, sin modificar el destinatario compartido; cuando se omite, la actualización se aplica al destinatario compartido y se propaga a todos los onboardings no terminales. Solo de solicitud, no se devuelve en las respuestas ni en los webhooks.
"1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"
Respuesta
Destinatario actualizado correctamente