Obtener cuentas de cobro
Nivel de seguridad requerida para este servicio
Medio (accessToken)
Objetivo
Devuelve las cuentas sobre las que podés generar QR de cobro. De la respuesta salen los identificadores portfolioId y personId que piden todos los demás endpoints de esta sección.
Se llama al integrar por primera vez, o cuando se te habilite una cuenta nueva. No hace falta llamarlo en cada cobro.
Request
curl -X GET "https://$env/external/api/get-collect-accounts" \
-H 'Authorization: $YOUR_ACCESS_TOKEN'env: Entorno de la API, como producción o desarrollo.YOUR_ACCESS_TOKEN: Token obtenido en el servicio de autenticación.
No recibe parámetros: devuelve todas las cuentas habilitadas para tus credenciales.
Ejemplo de Respuestas:
[
{
"account": {
"id": 4821,
"name": "Comercio Demo",
"cvu": "0000099900000012345678",
"status": "ACTIVE",
"adminGroup": "AbCdEf1234567890==",
"owners": [
{
"id": 7150934,
"taxNumber": 30123456789,
"legalName": "Comercio Demo S.A."
}
]
}
}
]Información adicional sobre campos
account.id: es elportfolioIdque piden los demás endpoints.account.owners[].id: es elpersonIdque piden los demás endpoints.adminGroup: identificador que agrupa el conjunto de cuentas de un mismo merchant.
Si tenés varias cuentas habilitadas, el array trae un elemento por cada una.
Nota: existe un endpoint equivalente en la API de SmartPos, Obtener cuentas, sobre la ruta /external/posdevice-api/get-collect-accounts. Devuelve los mismos datos y usa el mismo token: están separados por ruta para no mezclar contextos. Para generar QR de cobro, usá el de esta sección.