Destinatarios para marketplace
Listar destinatarios
Obtén una lista paginada de destinatarios de una cuenta autorizada.
GET
Listar destinatarios
Proporciona
account_id como parámetro de consulta, o X-Account-Code como encabezado. Si ambos están presentes, el parámetro de consulta tiene prioridad. Los resultados se limitan a esa cuenta autorizada y a tu organización, ordenados por fecha de creación, del más reciente al más antiguo.
Usa merchant_recipient_id para una coincidencia exacta, opcionalmente combinado con country y national_entity. Cada respuesta exitosa contiene data como un arreglo y pagination como un objeto, incluso cuando solo coincide un destinatario. Si no hay coincidencias, devuelve HTTP 200 con data: [] y pagination.total: 0.
limit tiene un valor predeterminado de 20 y acepta de 1 a 100. offset tiene un valor predeterminado de 0 y acepta cualquier entero no negativo. Los valores de filtro vacíos o repetidos no son válidos.
Cada elemento contiene los campos base del destinatario. Las colecciones relacionadas como withdrawal_methods, documentation, legal_representatives y onboardings no se enriquecen. Usa Get Recipient para obtener el destinatario completo.
Este listado está disponible en
GET /v1/recipients/list. La búsqueda existente Get Recipient by Merchant ID (GET /v1/recipients?merchant_recipient_id=...) permanece sin cambios: devuelve un objeto de destinatario de nivel superior y 400 RECIPIENT_NOT_FOUND cuando ningún destinatario coincide. Quienes ya usan la búsqueda no necesitan migrar. Los contratos de GET por ID de Yuno y de PATCH/DELETE no cambian.