network_error

Qué significa

La llamada no obtuvo respuesta de la API de CoatiPay. O no hubo respuesta —fallo de red, de DNS o timeout: status es null— o la que llegó no es un error de CoatiPay: el 502 en HTML de un proxy, un cuerpo vacío o que no es JSON. Entonces status es su código HTTP. Este código lo pone el SDK (NetworkError); la API nunca lo envía.

Cómo resolverlo

No se sabe si la petición surtió efecto. Una lectura se puede repetir sin más. Para crear un cobro, envía siempre una idempotency_key: si repites la llamada con la misma clave, la API devuelve el mismo cobro en vez de crear otro. Antes de repetir otra escritura (cancelar, enviar la autorización), consulta el cobro: su status dice si la primera llegó. Sin respuesta o con un 5xx, el fallo suele ser pasajero: reintenta con una espera creciente. Si persiste, escribe a hola@coatipay.com.

Cómo llega

Como NetworkError, que hereda de CoatiPaySDKError: el mismo catch cubre cualquier error de una llamada.

// JavaScript · @lacasoft/coatipay-sdk
} catch (e) {
  if (e instanceof NetworkError) e.status   // 502, o null sin respuesta
}

# Python · coatipay-sdk
except NetworkError as e:
    e.status

// PHP · lacasoft/coatipay-sdk
} catch (\CoatiPay\Errors\NetworkError $e) {
    $e->status;
}