Endpoints de cuenta

Detalle de cuenta

Consulta el estado actual de una cuenta directo en el banco usando el account_number. El worker no lee PaymentAccounts para esta ruta: va al proveedor externo con las credenciales del collector.

GET/api/v2/accounts/{account_number}Vía proveedor

Endpoint

Esta ruta sirve para inspección operativa sobre una cuenta puntual del collector.

GET/api/v2/accounts/{account_number}

Si account_number falta en el path, el handler devuelve validación. El detalle se consulta directo en el banco.

Parámetro de path

El único parámetro requerido viaja dentro de la URL.

Campo	Tipo	Notas
account_number	string	Número de cuenta (CVU) asignado al cobro.
customer_id	string	Identificador del cliente en el banco.
alias	string \| null	Alias activo. Puede ser null si no fue asignado.
email	string \| null	Email asociado a la cuenta en el banco.
on_received	string	Comportamiento al recibir una transferencia: accept o reject.

Cuándo usarlo

Úsalo para soporte operativo o para auditar el estado actual de una cuenta puntual en el banco. Para confirmar el negocio, seguí usando /api/v2/accounts/status.

Ejemplos

Snippets backend para leer una cuenta concreta.

curl "https://transferfix.com.ar/api/v2/accounts/0000277800000000195553" \
  -H "X-API-Key: ck_live_12345678_abcd"

Respuesta

El contrato exitoso devuelve un objeto account dentro de data.

Respuesta 200

{
  "success": true,
  "data": {
    "account": {
      "account_number": "0000277800000000195553",
      "customer_id": "pianta.demo.0001",
      "alias": "pianta.demo.0001",
      "email": null,
      "on_received": "accept"
    }
  }
}

Importante

Este endpoint refleja el estado actual en el banco. No devuelve montos cobrados ni el lifecycle CREATED / PAID; para eso está el endpoint de status sobre PaymentAccounts.